用途:该技能面向号码从 Telnyx 携出(port-out)的场景,提供 REST API 的 curl 调用示例,用于管理携出请求、查看状态并更新处理结果。
主要能力:列出携出请求(GET /portouts)与全部携出事件(GET /portouts/events),查看单个事件(GET /portouts/events/{id})并可重新发布事件(POST /portouts/events/{id}/republish);按携出 ID 查询可用的拒绝代码(GET /portouts/rejections/{portout_id});列出与创建携出报告(GET/POST /portouts/reports)及检索单个报告;获取单个携出请求详情(GET /portouts/{id});管理评论(GET/POST /portouts/{id}/comments);管理支持文档(GET/POST /portouts/{id}/supporting_documents);通过 PATCH /portouts/{id}/{status} 授权或拒绝携出请求,需提供 reason,可选 host_messaging。
使用方式:curl 在 macOS、Linux 和 Windows 10+ 上已预装。先设置环境变量:export TELNYX_API_KEY="YOUR_API_KEY_HERE",所有请求使用 Authorization: Bearer $TELNYX_API_KEY 认证。列表接口分页,使用 page[number] 与 page[size] 参数,并检查响应中的 meta.total_pages。
限制与错误处理:调用可能因网络错误、限流(429)、校验错误(422)或认证错误(401)失败,生产代码需处理。常见错误码:401 无效 API 密钥、403 权限不足、404 资源未找到、422 校验错误、429 限流(建议指数退避重试)。携出状态枚举包括 pending、authorized、ported、rejected、rejected-pending、canceled。具体收费、价格与平台支持信息暂未提供。