用途:面向 JavaScript/Node.js 开发者,演示如何通过 Telnyx SDK 配置账户访问相关资源,包括地址、SSO 认证提供方、Access IP 地址、计费组与集成密钥,并附带通话凭证访问令牌的创建示例。
主要能力分五类资源:一是 addresses,支持创建、检索、删除、分页列表,以及地址校验(POST /addresses/actions/validate,用于紧急服务)和接受地址建议(accept_suggestions,用于 Operator Connect 号码上传到 Microsoft)。二是 accessIPAddress,支持创建、检索、删除与分页列表,字段含 status(pending、added)等。三是 authenticationProviders,支持创建、检索、更新、删除与列表,settings 中可配置 SAML 的 idp_entity_id、idp_sso_target_url、idp_cert_fingerprint 等。四是 billingGroups,支持创建、获取、更新、删除与列表。五是 integrationSecrets,支持列表、创建(必填 identifier、type,可选 username、password、token)与删除;另有 telephonyCredentials.createToken 生成 JWT 访问令牌。
使用方式:先执行 npm install telnyx@6.74.2,再以 import Telnyx from 'telnyx' 引入,并用 apiKey: process.env['TELNYX_API_KEY'] 初始化客户端。列表方法返回自动分页迭代器,可用 for await...of 逐页遍历。示例需自行处理错误:捕获 APIConnectionError(网络)、RateLimitError(429,按 retry-after 退避重试)与 APIError(含 401、403、404、422 等状态判断)。
适用场景:需要以代码方式管理 Telnyx 账户的地址簿、单点登录提供方、IP 访问白名单、计费分组和集成密钥的集成开发与自动化。
限制:资料仅提供上述接口示例,未说明完整字段约束、权限模型、地区可用性、计费方式或调用配额;具体参数以 Telnyx 官方 API 文档为准。