用途
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 的场景,例如获取枚举值、检索黑盒测试结果。
限制
资料未提供除上述接口之外的更多功能、收费、价格、平台支持范围或效果说明,这些内容暂未提供。