用途:在 JavaScript 项目中为 Telnyx API 接入 OAuth 2.0 认证流程,提供可直接参考的 SDK 调用示例。
安装:npm install telnyx@6.74.2
初始化:import Telnyx from 'telnyx'; const client = new Telnyx({ apiKey: process.env['TELNYX_API_KEY'] });
主要能力:
- 授权服务器元数据与受保护资源元数据发现(GET /.well-known/oauth-authorization-server、/.well-known/oauth-protected-resource)。
- 授权码流程:client.oauth.retrieveAuthorize 获取授权端点,client.oauth.retrieve 查询 consent token,client.oauth.grants 创建授权许可。
- 令牌:client.oauth.token 用授权码、客户端凭证或刷新令牌换取访问令牌;client.oauth.introspect 校验令牌;client.oauth.retrieveJwks 获取 JWKS。
- 动态客户端注册(RFC 7591):client.oauth.register 注册新客户端。
- OAuth 客户端管理:client.oauthClients 的 list、create、retrieve、update、delete;OAuth 授权管理:client.oauthGrants 的 list、retrieve、delete。
使用要点:列表方法返回自动分页迭代器,可用 for await (const item of result) 自动遍历全部页。生产代码应处理错误:APIConnectionError(网络)、RateLimitError(429,建议指数退避重试,可参考 retry-after 头)、APIError(含 401/403/404/422 等状态)。
适用场景:需要以 OAuth 2.0 方式访问 Telnyx API 的 JavaScript 应用或服务端集成。
限制:示例假定 client 已初始化;文档未提供收费、价格、平台支持范围或性能数据,相关细节暂未提供。