用途:面向构建 IoT/M2M 解决方案的开发者,提供用 JavaScript SDK 管理 Telnyx IoT SIM 卡、eSIM、数据套餐与无线连接的能力。
安装与初始化:npm install telnyx@6.74.2。import Telnyx from 'telnyx'; 使用 new Telnyx({ apiKey: process.env['TELNYX_API_KEY'] }) 初始化客户端,随后调用各资源方法。
主要能力:购买并注册 eSIM(POST /actions/purchase/esims 必填 amount,可选 product、sim_card_group_id、status、tags、whitelabel_name);按注册码注册 SIM 卡(POST /actions/register/sim_cards 必填 registration_codes);列出批量 SIM 卡操作及详情(GET /bulk_sim_card_actions);列出和获取 OTA 更新(GET /ota_updates);列出与获取 SIM 卡操作详情(GET /sim_card_actions);管理 SIM 卡数据用量通知的增删改查(/sim_card_data_usage_notifications);管理 SIM 卡组 CRUD 及组级异步操作,包括设置/移除专用无线网关(set/remove_private_wireless_gateway)和无线黑名单(set/remove_wireless_blocklist)。列表方法返回自动分页迭代器,可用 for await (const item of result) 遍历全部页面。
错误处理:需捕获网络错误、限流(429)、校验错误(422)与认证错误(401);429 可读取 err.headers?.['retry-after'] 后指数退避重试;常见状态码含 401、403、404、422、429。
适用场景:IoT/M2M 平台批量开通与注册 SIM 卡、eSIM,监控数据用量,配置网络访问策略。
限制:以上为技能资料列出的接口与字段,未提供收费、价格、平台兼容性及速率上限等细节;实际调用前应确认账户权限与字段格式。