用途:通过 curl 调用 Telnyx REST API,配置账户级访问相关资源,包括地址、SSO 认证提供商、访问 IP 控制、计费组与集成密钥,并可为电话凭证创建访问令牌(JWT)。
主要能力:地址的列表、创建、校验、查询、删除,以及接受紧急地址建议;SSO 认证提供商的列表、创建、查询、更新、删除;访问 IP 地址的列表、创建、查询、删除;计费组的列表、创建、查询、更新、删除;集成密钥的列表、创建、删除;创建电话凭证访问令牌。列表接口分页,使用 page[number] 与 page[size],并检查 meta.total_pages。
使用方式:curl 在 macOS、Linux 和 Windows 10+ 中预装;设置 export TELNYX_API_KEY="YOUR_API_KEY_HERE",请求以 Authorization: Bearer $TELNYX_API_KEY 认证,基础地址为 https://api.telnyx.com/v2。例如列出访问 IP:curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/access_ip_address"。
错误处理:401 无效 API 密钥,403 权限不足,404 资源不存在,422 校验错误,429 触发限流。生产代码应处理网络错误并检查 HTTP 状态码,429 可延迟重试。
限制:资料未提供各端点所需权限范围、速率上限具体数值、计费与价格信息,也未提供各资源的可用区域或配额说明。