SuperAPI AI 工具集

telnyx-seti-curl

通用与其它

查看项目

更新于 10-16 05:36

技能介绍

用途

Telnyx SETI curl 技能用于通过 REST API 访问 SETI(Space Exploration Telecommunications Infrastructure,太空探索电信基础设施)接口。该技能以 curl 命令的形式提供调用示例,适合在命令行或脚本中直接使用。

主要能力

资料中列出的接口包括:

  • 获取枚举:GET /10dlc/enum/{endpoint}
  • 检索黑盒测试结果:GET /seti/black_box_test_results,返回 black_box_tests(对象数组)、product(字符串)、record_type(字符串)。

使用方式

安装:curl 在 macOS、Linux 和 Windows 10+ 上已预装,无需额外安装。

配置:设置环境变量 export TELNYX_API_KEY="YOUR_API_KEY_HERE",所有示例均使用 $TELNYX_API_KEY 进行认证。

调用示例(获取枚举):

curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/10dlc/enum/{endpoint}"

调用示例(检索黑盒测试结果):

curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/seti/black_box_test_results"

错误处理

所有 API 调用都可能因网络错误、速率限制(429)、验证错误(422)或认证错误(401)而失败,生产代码中应始终处理错误。资料给出的示例通过 curl -s -w "\n%{http_code}" 获取 HTTP 状态码,并配合 case 分支处理:2xx 表示成功,422 表示验证错误(检查必填字段与格式),429 表示速率受限(延迟后重试),401 表示认证失败(检查 TELNYX_API_KEY)。

常见错误码:401 无效 API 密钥,403 权限不足,404 资源未找到,422 验证错误(检查字段格式),429 速率受限(使用指数退避重试)。

适用场景

适用于需要通过命令行或脚本调用 Telnyx SETI 相关 REST API 的场景,例如获取枚举值、检索黑盒测试结果。

限制

资料未提供除上述接口之外的更多功能、收费、价格、平台支持范围或效果说明,这些内容暂未提供。