跳转至

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