SuperAPI AI 工具集

telnyx-oauth-curl

安全与审计

查看项目

更新于 10-16 04:56

技能介绍

用途:该技能用于为 Telnyx API 访问实现 OAuth 2.0 认证流程,全部以 curl 命令形式给出 REST API 示例。

主要能力:包含授权服务器元数据发现(GET /.well-known/oauth-authorization-server)、受保护资源元数据(GET /.well-known/oauth-protected-resource)、授权端点(GET /oauth/authorize)、获取 OAuth 同意令牌(GET /oauth/consent/{consent_token})、创建 OAuth 授权授予(POST /oauth/grants)、令牌自省(POST /oauth/introspect)、JSON Web Key Set(GET /oauth/jwks)、动态客户端注册(POST /oauth/register,RFC 7591)、令牌端点(POST /oauth/token)以及 OAuth 客户端的列表、创建、获取、更新、删除(/oauth_clients)和 OAuth 授权的列表、获取、吊销(/oauth_grants)。

使用方式:curl 已预装于 macOS、Linux 和 Windows 10+。先设置环境变量 export TELNYX_API_KEY="YOUR_API_KEY_HERE",所有示例使用该变量进行认证。调用时通过 -H "Authorization: Bearer $TELNYX_API_KEY" 与 -H "Content-Type: application/json" 发送请求。令牌端点需传入 grant_type,可选 client_id、client_secret、code、code_verifier、redirect_uri、refresh_token、scope 等。列表端点分页使用 page[number] 和 page[size],可查看 meta.total_pages。

错误处理:调用可能因网络错误、限流(429)、校验错误(422)或认证错误(401)失败。示例通过 -w "\n%{http_code}" 获取状态码并用 case 分支处理:401 表示 API 密钥无效,403 权限不足,404 资源不存在,422 校验错误,429 限流可重试(如 sleep 1)。生产代码建议对 429 使用指数退避。

限制与说明:该资料仅提供 curl 形式的 API 调用示例,未提供各端点的完整认证细节、官方价格、计费方式或与其它语言的 SDK 示例;部分端点(如动态客户端注册、同意令牌)的具体业务约束暂未提供。