使用 OAuth 2.0 访问薄荷 API

doc

关于 OAuth 2.0 协议规范，请参考 OAuth 2.0 。

OAuth 2.0 基本流程简介

OAuth 2.0 的流程大致可以简单概括为以下四步：

1. 应用向服务器发起授权申请
2. 服务器将用户重定向到授权页，询问用户是否对应用授权
3. 用户同意授权，服务器重定向到 redirect_uri （您的应用），并附加 authorization_code
4. 使用 authorization_code 向服务器请求 access_token，使用 access_token 访问需授权的 API

获取 authorization_code

接口地址：

GET /oauth/auth

参数：

请求示例：

https://boohee.host.example/oauth/auth?
  client_id=6c10ef8b98c158825abd&
  redirect_uri=https://example.host/callback

响应内容：

• 用户同意授权，重定向到 redirect_uri，并附加 autorization_code

https://example.host/callback?code=9b73a4248

• 用户拒绝授权，重定向到 redirect_uri

获取 access_token

接口地址：

POST /oauth/access_token

参数：

请求示例：

https://boohee.host.example/oauth/access_token?
  client_id=6c10ef8b98c158825abd&
  client_secret=78c99ad30629fea48c1ed333&
  redirect_uri=https://example.host/callback&
  grant_type=authorization_code&
  code=a8c04313b31a2806

响应内容：

{
  "access_token": "652d85781d9f3668f33b604f45696750",
  "token_expired_at": "2016-10-21T10:19",
  "refresh_token": "acd8578ss2dfe23g5643b604f456sf75ge0"
}

• refresh_token 只能使用一次，使用后将获得新的 access_token 和 refresh_token