SuperAPI AI 工具集

telnyx-account-access-python

部署与运维

查看项目

更新于 10-16 03:37

技能介绍

用途:该技能面向使用 Telnyx Python SDK 管理账户访问相关资源的开发者,覆盖地址、身份验证提供商、访问 IP 地址、账单组、集成密钥以及电话凭证令牌的配置。

主要能力:

  • 访问 IP 地址(access_ip_address):列出、创建、检索、删除,含 ip_address、description、status 等字段。
  • 地址(addresses):列出、创建、检索、删除地址,支持紧急服务地址校验(POST /addresses/actions/validate),以及接受地址建议(POST /addresses/{id}/actions/accept_suggestions)。
  • 身份验证提供商(authentication_providers):SSO 提供商的列出、创建、检索、更新、删除,settings 中可配置 IdP 证书指纹、实体 ID、SSO 目标 URL 等。
  • 账单组(billing_groups):列出、创建、获取、更新、删除。
  • 集成密钥(integration_secrets):列出、创建、删除,支持 bearer、token、username、password 等类型。
  • 电话凭证令牌:通过 POST /telephony_credentials/{id}/token 创建 Access Token(JWT)。

使用方式:先执行 pip install telnyx,然后导入 os 与 Telnyx,用 api_key=os.environ.get("TELNYX_API_KEY") 初始化客户端,之后调用各资源的 list、create、retrieve、update、delete 等方法。列表方法返回自动分页迭代器,可用 for item in page_result 遍历全部页面。

错误处理:官方示例建议在生产代码中捕获 telnyx.APIConnectionError、telnyx.RateLimitError 和 telnyx.APIStatusError。常见错误码包括 401(API 密钥无效)、403(权限不足)、404(资源不存在)、422(校验错误)、429(限流,可用指数退避并按 Retry-After 头等待重试)。

适用场景:需要以编程方式维护 Telnyx 账户的地址簿、单点登录配置、IP 访问白名单、账单分组与第三方集成密钥的团队。

限制:资料仅提供 Python SDK 示例,未说明其他语言实现、具体计费方式或价格、速率限制的具体阈值,也未提供除上述接口之外的账户管理能力。