用途:通过 Telnyx REST API 配置和管理电话号码,涵盖主叫 ID、呼叫转移、消息启用、连接分配等设置,使用 curl 调用。
主要能力:批量更新号码的消息配置文件(POST /messaging_numbers_bulk_updates)并查询状态;列出/查询带消息设置的号码(GET /mobile_phone_numbers/messaging、/phone_numbers/messaging);列出号码(GET /phone_numbers、/phone_numbers/slim、/phone_numbers/voice);验证号码所有权(POST /phone_numbers/actions/verify_ownership);批量删除号码、批量更新紧急设置、批量更新号码(POST /phone_numbers/jobs/...)并查询任务;查询、更新、删除单个号码(GET/PATCH/DELETE /phone_numbers/{id})。
使用方式:curl 已预装于 macOS、Linux 和 Windows 10+。设置环境变量 export TELNYX_API_KEY="YOUR_API_KEY_HERE",请求头使用 Authorization: Bearer $TELNYX_API_KEY 与 Content-Type: application/json。号码须为 E.164 格式(如 +13125550001),含 + 和国家代码,无空格、连字符或括号。列表接口分页,使用 page[number] 和 page[size],并检查 meta.total_pages。
限制与错误处理:API 可能返回网络错误、429 限流、422 校验错误或 401 认证错误,生产代码需处理。常见错误码:401 无效 API 密钥、403 权限不足、404 资源不存在、422 校验错误、429 限流(指数退避重试)。批量任务每次最多更新一千个号码。
适用场景:需要以脚本或自动化方式批量配置 Telnyx 号码、管理消息与语音设置、验证号码归属或执行批量删除/更新的场景。
暂未提供:具体收费、价格、平台支持范围及更多使用步骤未在资料中说明。