用途:通过 Telnyx REST API(curl 调用)管理消息托管号码、免付费号码验证与 RCS 富消息功能,适用于号码迁移或启用富消息能力时使用。
主要能力:托管号码订单的创建、列出、查询、删除、上传 LOA/账单文件、创建与校验验证码、号码资格检查;免付费验证请求的提交、列表、查询与更新;RCS 消息发送、生成 deeplink、RCS 代理的列出/查询/修改、批量与单个能力检查、添加测试号码。
使用方式:curl 在 macOS、Linux、Windows 10+ 预装。先设置环境变量 export TELNYX_API_KEY="YOUR_API_KEY_HERE",所有请求通过 Authorization: Bearer $TELNYX_API_KEY 认证,并携带 Content-Type: application/json。发送示例:POST https://api.telnyx.com/v2/messages,请求体含 to、from、text。电话号码须使用 E.164 格式(如 +13125550001),含 + 与国家代码,不可有空格、横线或括号。列表接口分页使用 page[number] 与 page[size],并检查响应中的 meta.total_pages。
限制与错误处理:API 可能返回网络错误、429 限流、422 校验错误、401 认证错误等。建议生产代码检查 HTTP 状态码:401 密钥无效、403 权限不足、404 资源不存在、422 字段格式错误、429 限流(指数退避重试)。资料未提供具体收费、价格与完整 RCS 代理配置说明。