OAuth¶
OAuth 接口用于第三方应用获取或刷新访问令牌(access_token)。拿到令牌后,后续业务接口按鉴权 里的任一方式携带即可。
该端点不在 API 域名下,也没有 /api/v5 版本前缀,这是与本文档其他分组最大的差别。
对象¶
| 对象 | 说明 | 相关接口 |
|---|---|---|
| 访问令牌 | 应用通过 OAuth 授权换取或刷新的 access_token | 获取或刷新授权 Token 接口 |
标识方式¶
- 端点固定为
POST https://atomgit.com/oauth/token(注意 Host 是atomgit.com,不是api.atomgit.com)。 - 授权方式、client 凭据与返回字段按具体接口页的参数表传。
常见任务¶
| 任务 | 接口 |
|---|---|
| 获取或刷新访问令牌 | POST https://atomgit.com/oauth/token |
注意事项¶
- 路径与其他接口不同族:没有
/api/v5前缀,Host 也不是api.atomgit.com,直接用 curl 拼路径时容易写成https://api.atomgit.com/oauth/token而失败。 - 该接口用于「获取或刷新」同一个动作,首次换取与后续刷新走同一端点。
- 令牌到手之后的调用方式(
Authorization: Bearer、PRIVATE-TOKEN头或access_token查询参数)见鉴权。
接口列表¶
本模块共 1 个接口。
| # | 接口 | 方法与路径 | 说明 |
|---|---|---|---|
| 1 | 获取或刷新授权 Token 接口 | POST https://atomgit.com/oauth/token |
用户调用通过此接口,用于获取或刷新访问令牌(access_token)的统一接口 |
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 gitcode-dev/atomgit-api-doc