用途:当需要在非 Node 后端(Go、Python、Java、PHP 等)、集成测试或管理脚本(curl 或各语言 HTTP 客户端)、以及自行管理令牌的网关/代理中直接调用 CloudBase Auth v2 的原始 HTTP 接口时使用。前端使用 @cloudbase/js-sdk@2.x 的 Web 登录,或 Node.js 使用 @cloudbase/node-sdk 的场景不适用;数据库、存储等非认证功能也不适用。
基础用法:环境 ID 拼出基础地址 https://${env}.ap-shanghai.tcb-api.tencentcloudapi.com/auth/v1,公共请求头包括 x-device-id(设备标识)、x-request-id(链路追踪 ID)、Authorization: Bearer <access_token>(用户接口),客户端凭证类接口用 HTTP basic auth(-u clientId:clientSecret)。需先确认 env、clientId、clientSecret 及流程类型(登录注册、匿名、令牌管理、用户操作)。
主要能力(场景):1) 用户名/密码登录 POST /signin,返回 access_token、refresh_token 和用户信息;2) 短信或邮箱注册:先 POST /verification 发送验证码,再 POST /verification/verify 校验,最后 POST /signup 注册;3) 匿名登录 POST /signin-anonymously,返回可后续升级为正式账号的令牌;4) 用刷新令牌换新访问令牌 POST /token(grant_type=refresh_token);5) 令牌校验 GET /token/introspect?token=...;6) 注销/吊销 POST /revoke;7) 用户操作:GET /user/me 获取当前用户、PATCH /user/password 改密码、DELETE /user/me 删除用户,以及 /user/providers 绑定/解绑第三方账号。
限制与注意:不得臆造端点或字段,以技能文件中的 URL 与 JSON 结构为准;不确定时查阅 HTTP API 文档。令牌为 JWT access token 加 refresh token,验证流程需先经独立验证端点。用户操作须做好安全防护并只记录最少必要信息。