用途:使用 TeXML 标记语言(兼容 TwiML)构建语音应用,并通过 curl 调用 Telnyx REST API 管理语音相关资源。
主要能力:呼叫方面支持发起外呼(POST /texml/Accounts/{account_sid}/Calls,必填 To、From、ApplicationSid)、查询单个呼叫、批量查询呼叫、更新呼叫;录音方面支持查询呼叫录音、发起录音、更新录音;还支持为呼叫启动与更新 siprec 会话、启动与更新媒体流(Streams);会议方面支持列出会议、查询会议、更新会议、列出/新增/查询/更新/删除会议参与者、列出会议录音与查询会议录音;队列方面支持列出队列资源。
使用方式:curl 在 macOS、Linux 和 Windows 10+ 上预装。设置环境变量 export TELNYX_API_KEY="YOUR_API_KEY_HERE",请求时携带 Authorization: Bearer $TELNYX_API_KEY 与 Content-Type: application/json。列表接口使用 page[number] 和 page[size] 分页,并检查响应中的 meta.total_pages。
错误处理:需处理网络错误、429 限流、422 校验错误、401 认证错误。常见状态码:401 无效 API 密钥、403 权限不足、404 资源不存在、422 校验错误、429 限流(可用指数退避重试)。
限制:部分端点最终一致性;更新呼叫时 payload 键必须使用 CamelCase;具体价格、配额与平台支持范围资料未提供。