Telnyx IoT 技能（telnyx-iot-curl）是一组基于 curl 的 REST API 示例集合，用于管理 IoT SIM 卡、eSIM、数据套餐与无线连接，适合在构建 IoT/M2M 解决方案时参考使用。
用途 该技能面向需要以命令行方式调用 Telnyx IoT 相关 REST API 的开发者，提供可直接运行的 curl 示例，覆盖 eSIM 购买、SIM 卡注册、SIM 卡操作与批量操作查询、OTA 更新查询、数据用量通知管理以及 SIM 卡组管理等功能。
主要能力
- 购买 eSIM：POST /actions/purchase/esims，必填 amount，可选 product、sim_card_group_id、status、tags、whitelabel_name。
- 注册 SIM 卡：POST /actions/register/sim_cards，必填 registration_codes，可选 sim_card_group_id、status、tags。
- 查询批量 SIM 卡操作列表与详情：GET /bulk_sim_card_actions 与 GET /bulk_sim_card_actions/{id}。
- 查询 OTA 更新列表与详情：GET /ota_updates 与 GET /ota_updates/{id}。
- 查询 SIM 卡操作列表与详情：GET /sim_card_actions 与 GET /sim_card_actions/{id}。
- 管理 SIM 卡数据用量通知：列表、创建、获取单个、更新、删除（GET/POST/PATCH/DELETE /sim_card_data_usage_notifications）。
- 管理 SIM 卡组：列表、创建、获取、更新、删除（GET/POST/PATCH/DELETE /sim_card_groups）。
- 管理 SIM 卡组动作：查询列表与详情，以及请求移除私有无线网关、移除无线阻止列表、分配私有无线网关（POST /sim_card_groups/{id}/actions/...）。
使用方式 curl 在 macOS、Linux 和 Windows 10+ 上已预装。设置环境变量：export TELNYX_API_KEY="YOUR_API_KEY_HERE"。所有示例均使用 $TELNYX_API_KEY 进行认证，请求头为 Authorization: Bearer $TELNYX_API_KEY 与 Content-Type: application/json。示例中展示了通过 -w "\n%{http_code}" 获取 HTTP 状态码，并用 case 语句处理 2xx、422、429、401 等情况的错误处理写法。
错误处理 常见错误码：401 无效 API 密钥，403 权限不足，404 资源未找到，422 校验错误（检查字段格式），429 触发限流（建议使用指数退避重试）。
分页 列表接口返回分页结果，可使用 page[number] 与 page[size] 查询参数翻页，并检查响应中的 meta.total_pages。
适用场景 适用于构建 IoT/M2M 解决方案时，通过命令行或脚本调用 Telnyx REST API 完成 SIM 卡与 eSIM 生命周期管理、数据用量监控、SIM 卡组配置及无线网络策略设置等任务。
限制 该技能仅提供 curl 形式的 REST API 示例，未提供其他语言 SDK 或图形界面。具体计费、价格、平台支持范围等信息暂未提供。