SuperAPI AI 工具集

telnyx-numbers-services-curl

通用与其它

查看项目

更新于 10-16 03:39

技能介绍

用途:该技能面向 Telnyx 电话号码服务管理,通过 curl 调用 Telnyx REST API,配置语音通道(Channel Billing,分美国区与非美国区 Zone)、语音信箱以及动态紧急地址与紧急端点(E911 相关)。

主要能力:

  • 非美国区语音通道:GET /channel_zones 列出通道区域;PUT /channel_zones/{channel_zone_id} 更新通道数量(必填 channels)。
  • 美国区语音通道:GET /inbound_channels 列出;PATCH /inbound_channels 更新通道数(必填 channels)。
  • 通道计费号码查询:GET /list 按 Zone 分组列出所有使用 Channel Billing 的号码;GET /list/{channel_zone_id} 查询指定 Zone 的号码。
  • 动态紧急地址:GET /dynamic_emergency_addresses 列表;POST /dynamic_emergency_addresses 创建(必填 house_number、street_name、locality、administrative_area、postal_code、country_code);GET /dynamic_emergency_addresses/{id} 查询;DELETE /dynamic_emergency_addresses/{id} 删除。
  • 动态紧急端点:GET /dynamic_emergency_endpoints 列表;POST /dynamic_emergency_endpoints 创建(必填 dynamic_emergency_address_id、callback_number、caller_name);GET /dynamic_emergency_endpoints/{id} 查询;DELETE /dynamic_emergency_endpoints/{id} 删除。
  • 语音信箱:GET /phone_numbers/{phone_number_id}/voicemail 查询;POST 创建;PATCH 更新;字段为 enabled(boolean)、pin(string)。

使用方式:curl 已预装于 macOS、Linux 与 Windows 10+。设置环境变量 export TELNYX_API_KEY="YOUR_API_KEY_HERE",所有请求通过 Authorization: Bearer $TELNYX_API_KEY 头鉴权,基础地址为 https://api.telnyx.com/v2。

错误处理:可能返回 401 鉴权失败、403 权限不足、404 资源不存在、422 校验错误、429 限流。示例用 -w "\n%{http_code}" 获取状态码并用 case 分支处理;429 建议延迟重试(如 sleep 1,并采用指数退避)。

分页:列表端点分页返回,使用 page[number] 与 page[size] 查询参数翻页,并检查响应中的 meta.total_pages。

限制:具体价格、配额上限、字段取值约束及生产部署细节暂未提供;示例中的号码、ID 与地址均为占位数据,需替换为真实值。