Question

为了构建更好的生态环境，我们推出了基于 OAuth2 的 API 版本。API 接口使用方式以及 Url 都参照 GitHub，为了各位开发者更好的兼容已经存在的第三方应用。

API 使用条款

• 用户是资源的拥有者，需尊重和保护用户的权益。
• 不能在应用中使用 文江博客 的名称。
• 未经用户允许，不准爬取或存储用户的资源。
• 禁止滥用 API，请求频率过快将导致请求终止。

基本流程

认证步骤

1、应用通过 浏览器 或 Webview 将用户引导到文江博客三方认证页面上

https://www.wenjiangs.com/oauth/authorize?client_id={client_id}&redirect_uri={redirect_uri}&response_type=code

2、用户对应用进行授权

3、文江博客认证服务器通过回调地址 {redirect_uri} 将 用户授权码 传递给 应用服务器 或者直接在 Webview 中跳转到携带 用户授权码的回调地址上，Webview 直接获取 code 即可（ {redirect_uri}?code=abc&state=xyz ）

4、应用服务器 或 Webview 使用 access_token API 向 文江博客认证服务器发送 post 请求传入 用户授权码 以及 回调地址

https://www.wenjiangs.com/api/v2/oauth/token
{
  grant_type: authorization_code,
  code: {code},
  client_id: {client_id},
  redirect_uri: {redirect_uri},
  client_secret: {client_secret}
}

文江博客认证服务器返回 access_token

6、应用通过 access_token 访问 Open API 使用用户数据。

7、当 access_token 过期后（有效期为30天），你可以通过 post 请求发送 refresh_token 重新获取 access_token

https://www.wenjiangs.com/api/v2/oauth/token
{
  grant_type: refresh_token,
  refresh_token: {refresh_token}
}