SuperAPI AI 工具集

telnyx-account-management-python

编程与开发

查看项目

更新于 10-16 03:36

技能介绍

用途:面向经销商和企业场景,用 Python SDK 管理 Telnyx 的子账户(managed accounts)及组织用户。需被 Telnyx 明确批准为 manager account 才能使用相关能力。

安装与初始化:pip install telnyx;初始化 client = Telnyx(api_key=os.environ.get("TELNYX_API_KEY")),后续示例均假设 client 已初始化。

主要能力:列出当前用户管理的账户(GET /managed_accounts,列表方法返回自动翻页迭代器,可 for item in page_result 遍历全部页面);创建 managed account(POST /managed_accounts,必填 business_name,可选 email、managed_account_allow_custom_pricing、password、rollup_billing);查看可分配的全局出站通道信息(GET /managed_accounts/allocatable_global_outbound_channels,仅 account manager 可用);检索、更新单个 managed account(GET/PATCH /managed_accounts/{id});禁用与启用账户(POST /managed_accounts/{id}/actions/disable 与 enable,enable 可选 reenable_all_connections);更新指定账户的全局通道限额(PATCH /managed_accounts/{id}/update_global_channel_limit,可选 channel_limit);以及组织用户管理:列出组织用户、获取用户分组报告、获取单个用户、删除用户(POST /organizations/users/{id}/actions/remove)。

错误处理:网络错误用 telnyx.APIConnectionError;限流用 telnyx.RateLimitError(429,建议按 Retry-After 指数退避重试);其他用 telnyx.APIStatusError(如 401 无效密钥、403 权限不足、404 未找到、422 校验错误)。

限制:调用需要有效的 TELNYX_API_KEY;大量管理操作要求账户被 Telnyx 批准为 manager account;部分端点仅 account manager 可用。文档未提供具体收费与价格信息。