用途:该技能面向构建 IoT/M2M 解决方案的开发者,提供使用 curl 调用 Telnyx REST API 的示例,用于管理 IoT SIM 卡、eSIM、数据套餐与无线连接。
主要能力:涵盖购买 eSIM(POST /actions/purchase/esims,必填 amount)、注册 SIM 卡(POST /actions/register/sim_cards,必填 registration_codes)、批量 SIM 卡操作查询、OTA 更新查询、SIM 卡操作查询、SIM 卡数据用量通知的增删改查、SIM 卡组及其动作(如设置/移除私有无线网关、无线阻止列表)等接口。
使用方式:curl 在 macOS、Linux 和 Windows 10+ 上预装。先设置环境变量 export TELNYX_API_KEY="YOUR_API_KEY_HERE",所有请求通过 Authorization: Bearer $TELNYX_API_KEY 认证。示例请求基址为 https://api.telnyx.com/v2。列表接口支持分页,使用 page[number] 和 page[size] 参数,并检查响应中的 meta.total_pages。
错误处理:需处理网络错误、限流(429)、校验错误(422)和认证错误(401)。常见状态码包括 401 无效 API 密钥、403 权限不足、404 资源不存在、422 校验错误、429 限流(建议指数退避重试)。
限制:资料未提供具体收费、价格、平台支持范围或性能效果等信息;部分接口的完整返回字段在资料中被截断,暂未提供完整内容。