用途:为 Telnyx API 访问实现 OAuth 2.0 认证流程,并提供 Ruby SDK 示例。
安装与初始化:gem install telnyx;通过 require "telnyx" 引入,client = Telnyx::Client.new(api_key: ENV["TELNYX_API_KEY"]),后续示例均假设已按此初始化。
主要能力:读取授权服务器元数据(client.well_known.retrieve_authorization_server_metadata)与受保护资源元数据;OAuth 授权端点(client.oauth.retrieve_authorize);获取同意令牌详情(client.oauth.retrieve);创建授权(client.oauth.grants);令牌内省(client.oauth.introspect);获取 JWKS(client.oauth.retrieve_jwks);动态客户端注册(client.oauth.register,RFC 7591);令牌端点(client.oauth.token,支持授权码、客户端凭证、刷新令牌);以及 OAuth 客户端的增删改查(client.oauth_clients)与 OAuth 授权的列表、获取和撤销(client.oauth_grants)。
错误处理:调用可能返回网络错误、429 限流、422 校验错误或 401 认证错误,需在生产代码中捕获 Telnyx::Errors 各异常;429 可用指数退避重试(并参考 Retry-After),422 检查字段格式。
分页:使用 page.auto_paging_each 自动迭代。
限制:资料未说明技能所适用的具体运行环境、版本要求或收费情况。