用途:该技能面向需要使用 JavaScript 管理 Telnyx SIP 基础设施的开发者,主要覆盖 SIP 中继连接(connections)、凭证连接(credential_connections)、FQDN 连接(fqdn_connections)以及访问 IP 范围(access_ip_ranges)的配置,常见于连接 PBX 系统或维护出站语音配置的场景。
主要能力:
- 连接管理:GET /connections 列出所有类型的连接,GET /connections/{id} 获取单个连接的高层详情。连接对象包含 active、connection_name、outbound_voice_profile_id、tags、webhook_event_url、webhook_api_version 等字段。
- 凭证连接:支持列出、创建(必填 user_name、password、connection_name)、查询、更新(PATCH)与删除。可配置 DTMF 类型(RFC 2833、Inband、SIP INFO)、加密媒体(SRTP 或 None)、噪声抑制、抖动缓冲、RTCP 设置、SIP URI 呼叫偏好、T38 透传、webhook 超时等。
- 注册状态检查:POST /credential_connections/{id}/actions/check_registration_status 返回 ip_address、port、transport、user_agent、last_registration 以及状态(Registered、Unregistered、Failed、Expired、Not Applicable 等)。
- FQDN 连接:支持列出与创建,可选参数包括 transport_protocol(UDP/TCP/TLS)、txt_name、txt_ttl、txt_value、microsoft_teams_sbc、adjust_dtmf_timestamp 等。
- 访问 IP 范围:GET/POST/DELETE /access_ip_ranges,创建时必填 cidr_block,状态枚举为 pending、added。
使用方式:先执行 npm install telnyx,然后在代码中 import Telnyx from 'telnyx',用 new Telnyx({ apiKey: process.env['TELNYX_API_KEY'] }) 初始化客户端。列表方法返回自动分页迭代器,可用 for await (const item of client.connections.list()) 逐页遍历。所有 API 调用需处理错误:APIConnectionError(网络)、RateLimitError(429,建议指数退避重试)、APIError(含 401、403、404、422 等状态)。
限制:资料仅提供上述接口与字段说明,未给出定价、平台限制、配额细节或完整示例链路;实际使用需自备 TELNYX_API_KEY,并遵循错误处理建议。