SuperAPI AI 工具集

telnyx-porting-in-curl

办公与效率

查看项目

更新于 10-16 05:41

技能介绍

用途:帮助开发者用 curl 调用 Telnyx REST API,把电话号码携入(Porting In)Telnyx,覆盖可携性检查、携号订单创建与管理、LOA 文件配置、携号事件、携号报告及英国运营商查询等操作。

主要能力:运行号码可携性检查(POST /portability_checks);列出、查看、重发携号事件(GET /porting/events 等);管理 LOA 配置的增删改查与预览(/porting/loa_configurations);创建和获取携号报告(/porting/reports);查询英国可用运营商(/porting/uk_carriers);携号订单的列出、创建、查看、编辑、删除,以及异步激活、取消、提交确认等动作(/porting_orders 及 /actions/...);查询异常类型和电话号码配置。

使用方式:curl 在 macOS、Linux、Windows 10+ 通常已预装。先设置鉴权环境变量:export TELNYX_API_KEY="YOUR_API_KEY_HERE"。请求统一以 Authorization: Bearer $TELNYX_API_KEY 鉴权,请求体为 JSON。号码必须使用 E.164 格式,如 +13125550001,包含 + 号和区号,不带空格、连字符或括号。创建携号订单必需 phone_numbers 字段,可附带 customer_group_reference、customer_reference。列表接口分页,使用 page[number] 和 page[size] 查询参数,并查看响应中的 meta.total_pages。

适用场景:需要以脚本或自动化方式批量携入号码、生成和预览 LOA 文件、跟踪携号进度,以及导出携号订单 CSV 报告的场景。

限制与错误处理:API 调用可能出现网络错误、限流(429)、校验错误(422)和鉴权错误(401)。生产代码应处理状态码:401 表示 API 密钥无效,403 权限不足,404 资源不存在,422 字段格式校验失败,429 需延迟重试(可用指数退避)。删除携号订单仅限 draft 状态;异步激活操作仅支持美国 FastPort 订单。可携性检查可能返回 fast_portable、not_portable_reason、portable 等字段。其他功能、收费、价格及平台信息暂未提供。