网页授权登录

网页用户登录授权可打通帆书账号体系，可以获取到帆书用户的收藏内容，已购内容及用户的个人基本信息。

接入流程为以下三步：

1. 引导用户进入授权页面同意授权，获取code

2. 通过code换取授权access_token（与基础支持中的access_token不同）

3. 通过网页授权access_token和client_id获取用户基本信息

1.引导用户进入授权页面同意授权，获取code

用户登录樊登授权网页
HTTP请求方式：get
https://card.dushu365.com/hybrid/auth?responseType=code&clientId=CLIENT_ID&redirectUri=REDIRECT_URI

参数说明

用户同意授权

用户同意授权之后，页面将跳转至 redirect_uri/?code=CODE

code说明 ： code作为换取access_token的票据，每次用户授权带上的code将不一样，code只能使用一次，5分钟未被使用自动过期。

错误返回码说明

2.通过code换取授权access_token

*与基础支持中的access_token不同

首先请注意，这里通过code换取的是一个特殊的授权access_token,与基础支持中的access_token（该access_token用于调用其他接口）不同。应用可通过下述接口来获取网页授权access_token 和 openid。

尤其注意：由于应用的secret和获取到的access_token安全级别都非常高，必须只保存在服务器，不允许传给客户端。后续通过access_token获取用户信息等步骤，也必须从服务器发起。

HTTP请求方式：post
https://open-platform-test.dushu365.com/oauth1/fd/token?grant_type=authorization_code&code=CODE&client_id=CLIENT_ID&client_secret=CLIENT_SECRET

参数说明

样例

正常返回样例

{
  "accessToken": "e1f21696-a9a6-4d0d-a8d4-fd8d1c44d7da",
  "expiresIn": 7199,
  "openid": "ZOGmm-EhjRAu750wR78V1m",
  "refreshToken": "9861eb64-3825-424e-bfba-115af5e8ef1b"
}

样例参数说明

错误返回样例

错误时，返回JSON结果

{
    "error": "invalid_client",
    "error_description": "Bad client credentials"
}

该错误表明错误为无效的凭证，请检查请求的appId或appSecret的值是否正确。

样例参数说明

3.通过网页授权access_token和client_id获取用户基本信息

HTTP请求方式：get
access_token：
https://open-platform-test.dushu365.com/sns/userinfo?access_token=ACCESS_TOKEN&client_id=APPID

参数说明

样例

正常返回样例

{
    "data": {
        "feifanVip": ISVIP,
        "feifanVipEndTime": VIPENDTIME,
        "isVip": ISVIP,
        "nickname": NICKNAME,
        "headimgurl":HEADIMGURL,
        "openid": OPENID,
        "vipEndTime": VIPENDTIME
    },
    "msg": "操作成功！",
    "status": "0000",
    "systemMsg": "操作成功！",
    "systemTime": 1629360296482
}

样例参数说明

4.通过refreshToken刷新access_token

HTTP请求方式：post
https://open-platform-test.dushu365.com/oauth1/fd/token?grant_type=refresh_token&refresh_token=94bc3507-e7ee-4708-b1b1-0c2f03dccb7d&client_id=xxxx

参数说明

样例

正常返回样例

{
  "accessToken": "e1f21696-a9a6-4d0d-a8d4-fd8d1c44d7da",
  "expiresIn": 7199,
  "openid": "ZOGmm-EhjRAu750wR78V1m",
  "refreshToken": "9861eb64-3825-424e-bfba-115af5e8ef1b"
}

样例参数说明