用途:该技能提供使用 curl 调用 Telnyx REST API 的示例,用于配置 SIP 中继连接与出站语音配置,适合连接 PBX 系统或管理 SIP 基础设施。
主要能力:覆盖访问 IP 范围(列出、创建、删除)、连接(列出、检索)、凭证连接(列出、创建、检索、更新、删除、检查注册状态)、FQDN 连接(列出、创建)等接口。凭证连接支持设置用户名、密码、连接名,以及 DTMF 类型、加密媒体(SRTP/None)、噪声抑制、抖动缓冲、Webhook 等参数。
使用方式:curl 在 macOS、Linux、Windows 10+ 已预装。先设置环境变量:export TELNYX_API_KEY="YOUR_API_KEY_HERE",随后所有请求使用 Authorization: Bearer $TELNYX_API_KEY 认证,基础地址为 https://api.telnyx.com/v2。例如列出连接:curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/connections?sort=connection_name"。
错误处理:需处理网络错误、限流(429)、校验错误(422)、认证错误(401)等;常见代码包括 401 密钥无效、403 权限不足、404 资源不存在、422 字段格式问题、429 限流(建议指数退避重试)。
限制:列表接口分页,使用 page[number] 与 page[size] 参数,并检查响应中的 meta.total_pages。资料未提供收费、价格、平台支持范围或具体使用效果等信息。