用途:该技能面向 Telnyx 号码合规场景,提供一组 REST API 的 curl 示例,用于查询与管理监管要求、号码套餐(bundle)、支持文档和电话号码相关的合规信息。
主要能力:
- 套餐:列出全部 billing bundles、按 ID 获取套餐、获取及分页列出用户套餐、批量创建用户套餐、查询未使用套餐、按 ID 获取用户套餐、停用用户套餐、获取套餐资源。
- 文档:列出 document links 与 documents(支持 filter、sort),上传(须在 30 分钟内关联服务,否则自动删除)、获取、更新、删除(须先解除服务关联)、下载、生成免认证的临时预签名下载链接。
- 监管要求:检索号码的监管要求与需求列表,列出/创建/获取/更新/删除 requirement group,提交审批,更新号码订单及子订单的 requirement group;查询 requirement types 与 requirements(支持过滤、排序、分页)。
使用方式:curl 在 macOS、Linux 和 Windows 10+ 已预装。执行 export TELNYX_API_KEY="YOUR_API_KEY_HERE" 进行认证,所有示例以 Authorization: Bearer $TELNYX_API_KEY 传递凭证。电话号码须为 E.164 格式,如 +13125550001,含 + 和国家代码,不得含空格、短横线或括号。列表端点分页,使用 page[number]、page[size],并检查响应的 meta.total_pages。
错误处理:生产代码应检查 HTTP 状态码。常见错误包括 401 无效 API key、403 权限不足、404 资源不存在、422 校验错误、429 限流(需指数退避重试)。示例会分离响应体与状态码后按状态码分支处理。
限制:资料未提供该技能的额外平台支持、价格或收费信息;文档上传后的 30 分钟关联时限和删除前须解除关联为明确约束。其余功能细节以 Telnyx API 文档为准。