SuperAPI AI 工具集

telnyx-account-management-curl

通用与其它

查看项目

更新于 10-16 05:41

技能介绍

用途:该技能提供 Telnyx 账户管理的 REST API(curl)示例,面向经销商和企业场景管理子账户(托管账户)与组织用户。成为管理者账户需经 Telnyx 明确批准。

认证与准备:curl 在 macOS、Linux 及 Windows 10+ 上已预装。使用前设置 export TELNYX_API_KEY="YOUR_API_KEY_HERE",所有示例通过 Bearer 令牌认证。

主要能力(接口):GET /managed_accounts 列出当前用户管理的账户,支持 filter、sort、include_cancelled_accounts 参数;POST /managed_accounts 创建托管账户,必填 business_name,可选 email、password、rollup_billing、managed_account_allow_custom_pricing;GET /managed_accounts/{id} 获取详情;PATCH /managed_accounts/{id} 更新账户;POST /managed_accounts/{id}/actions/disable 禁用账户(禁止使用 Telnyx 服务,进行中的通话不受影响);POST /managed_accounts/{id}/actions/enable 启用账户,可选 reenable_all_connections;GET /managed_accounts/allocatable_global_outbound_channels 查看可分配的全局出站通道;PATCH /managed_accounts/{id}/update_global_channel_limit 调整账户通道上限;组织用户相关接口包括 GET /organizations/users 列表、GET /organizations/users/users_groups_report 用户分组报告(不分页,支持 JSON 或 CSV)、GET /organizations/users/{id} 单个用户、POST /organizations/users/{id}/actions/remove 删除用户。

错误处理:调用可能因网络、429 限流、422 校验或 401 认证失败。可通过 curl -s -w "\n%{http_code}" 获取状态码,并区分 401(密钥无效)、403(权限不足)、404(资源不存在)、422(字段格式)、429(退避重试)。

分页:列表接口返回分页结果,使用 page[number] 和 page[size] 参数翻页,并检查响应中的 meta.total_pages。

适用场景:经销商、企业客户在脚本或自动化流程中批量管理子账户与组织用户。

限制:成为管理者账户需 Telnyx 批准;仅提供 REST 示例,未提供其他语言 SDK、价格、速率等未在此资料中说明的信息。