SuperAPI AI 工具集

telnyx-account-management-python

办公与效率

查看项目

更新于 10-16 05:41

技能介绍

用途:该技能面向 Telnyx 的经销商和企业客户,提供用 Python SDK 管理子账户(托管账户)与组织用户的示例。安装命令为 pip install telnyx,需先初始化客户端 Telnyx(api_key=os.environ.get("TELNYX_API_KEY"))。

主要能力:托管账户方面可列出当前用户管理的账户(GET /managed_accounts)、创建新托管账户(POST /managed_accounts,必填 business_name,可选 email、password、rollup_billing、managed_account_allow_custom_pricing)、查询单个账户(GET /managed_accounts/{id})、更新账户(PATCH,可选 managed_account_allow_custom_pricing)、禁用账户(POST /managed_accounts/{id}/actions/disable)、启用账户(POST /managed_accounts/{id}/actions/enable,可选 reenable_all_connections),以及查看和调整可分配的全局外呼通道(GET /managed_accounts/allocatable_global_outbound_channels、PATCH /managed_accounts/{id}/update_global_channel_limit)。组织用户方面可列出组织用户、获取用户分组报告(支持 JSON 或 CSV)、查询单个用户、删除用户(POST /organizations/users/{id}/actions/remove)。

使用方式:所有 API 调用都在已初始化的 client 上调用,如 client.managed_accounts.list()。列表方法返回自动分页迭代器,可用 for item in page_result 遍历全部页。

错误处理:需捕获 telnyx.APIConnectionError(网络错误)、telnyx.RateLimitError(429,按 Retry-After 退避重试)、telnyx.APIStatusError(含状态码)。常见错误:401 密钥无效、403 权限不足、404 资源不存在、422 校验错误、429 限流。

限制:成为管理账户需 Telnyx 明确批准;禁用账户会阻止其使用 Telnyx 服务,但进行中的通话不受影响;可分配全局外呼通道接口仅账户管理者可用。价格等其它信息暂未提供。