[关闭]
@myyzs 2017-09-11T03:04:46.000000Z 字数 2238 阅读 26

云助手扫码登录-接口设计

扫码页面


地址:https://open.fdccloud.com/connect/qrconnect?app_id=@app_id&redirect_uri=@redirect_uri
请求方式:GET

参数 描述
app_id 应用的app_id
redirect_uri 应用的回调uri地址,APP扫码确认登录后会调用这个地址

生成uuid


地址:https://open.fdccloud.com/connect/uuid?app_id=@app_id
请求方式:GET

参数 描述
app_id 应用的app_id

返回值

  1. {
  2. errcode:1,
  3. errmsg:"",
  4. data:{
  5. uuid:"abcde12312"
  6. }
  7. }
参数 描述
errcode 错误码
errmsg 错误信息
uuid 生成的uuid = AES(app_id+app_name+timestamp+php生成的唯一系列)

错误码定义

errcode 描述
1 正常
100 app_id不合法

生成二维码


地址:https://open.fdccloud.com/connect/qrcode?uuid=@uuid
请求方式:GET

参数 描述
uuid

返回值

  1. 二维码图片(Content-Type:image/jpeg
  2. 二维码图片对应的文本为:https://open.fdccloud/connect/confirm?uuid=@uuid

查询二维码状态


地址:https://open.fdccloud.com/connect/qrconnect?uuid=@uuid
请求方式:GET

参数 描述
uuid uuid接口返回的唯一标识

返回值

  1. {
  2. errcode:1,
  3. errmsg:"",
  4. data:{
  5. code:"abcde12312
  6. }
  7. }
参数 描述
errcode 返回码
errmsg 错误信息
code 临时授权码 = AES(wzs_user_id+app_id+timestamp),10分钟内有效

返回码定义

errcode 描述
1 用户扫码且确认登录
100 uuid不合法
101 二维码还没有被扫描
102 二维码被扫描
103 用户扫码但是取消登录)
104 二维码过期,过期时间为5分钟

特殊说明

此接口为阻塞型,最长30s返回结果,
当uuid状态发生变化,返回uuid对应的状态

APP扫码


接口功能:当APP调用此接口时,需要往数据库插入对应的记录
uuid,wzs_user_id,status,code等,当type=confirm时,需要生成临时授权码code=AES(wzs_user_id+app_id+timestamp),10分钟有效

地址:https://open.fdccloud.com/connect/confirm?uuid=@uuid&type=@type&access_token=@access_token

请求方式:POST

post内容 (内容通过AES加密)

  1. {
  2. "wzs_user_id": "@wzs_user_id",
  3. "platform": "@platform",
  4. "version_name": "3.1.5"
  5. }
参数 描述
uuid uuid接口返回的唯一标识
type confirm:确认登录 scan:APP扫码完成待确认 cancel:取消登录

返回值

  1. {
  2. errcode:1,
  3. errmsg:"",
  4. }
参数 描述
errcode 返回码
errmsg 错误信息

返回码定义

errcode 描述
1 正常
100 type不合法 (confirm,scan,cancel)
101 二维码过期,过期时间为5分钟

获取access_token


接口功能:第三方通过临时授权码获取access_token

地址:https://open.fdccloud.com/connect/get-access-token?app_id=@app_id&app_secret=@app_secret&code=@code

请求方式:GET

参数 描述
app_id 应用唯一标识
app_secret 应用秘钥
code 临时授权码

返回值

  1. {
  2. errcode:1,
  3. errmsg:"",
  4. data:{
  5. access_token:"access_token"
  6. }
  7. }
参数 描述
errcode 返回码
errmsg 错误信息
access_token 需要包含wzs_user_id,timestamp信息来标识身份和控制时效性(2小时内有效)

返回码定义

errcode 描述
1 正常
100 app_id或者app_secret不合法
101 临时授权码无效(错误的授权码)
102 临时授权码过期

获取获取用户信息


接口功能:第三方通过access_token获取用户信息

地址:https://open.fdccloud.com/connect/get-user-info?access_token=@access_token

请求方式:GET

返回值

  1. {
  2. errcode:1,
  3. errmsg:"",
  4. data:{
  5. wzs_user_id:"wzs123444",
  6. open_id"1213213"
  7. user_code:"meiy02"
  8. user_name:"梅义"
  9. avatar:"https://avatar.png"
  10. }
  11. }
参数 描述
errcode 返回码
errmsg 错误信息
wzs_user_id wzs用户id
user_code 用户code
user_name 用户名称
avatar 用户头像

返回码定义

errcode 描述
1 正常
100 access_token无效(错误的access_token)
101 access_token过期
添加新批注
在作者公开此批注前,只有你和作者可见。
回复批注