项目作者: xxjwxc

项目描述 :
golang oauth2 authorization tools , oauth2通用授权系统
高级语言: C
项目地址: git://github.com/xxjwxc/oauth2.git
创建时间: 2019-06-27T14:27:38Z
项目社区:https://github.com/xxjwxc/oauth2

开源协议:

下载


简要描述:

以下为
Content-Type = application/json
数据格式为json格式

  • 用户登录接口

请求域名:

请求URL:

POST:/api/v1/authorize

参数:

参数名 是否必须 类型 说明
appid string appid用于授权登录
token_type string 登录的应用标记
username string 用户名
password string 密码
time sring 当前登录的时间戳
token string 密钥校验值

其中:token = MD5(appid + username + password + times + secret )
其中:secret为系统获取

返回示例:

正确时返回:

  1. {
  2. "state": true,
  3. "error": "默认返回值",
  4. "data":{
  5. "access_token": "2DNweL5l6MOm1ftxzP8UreP6xKd2BBme",
  6. "expire_time": "10000",
  7. "refresh_token": "qIhC0BLYESjN5mAjFN29QlEGvJgAzJ5U"
  8. }
  9. }

错误时返回:

  1. {
  2. "state": false,
  3. "code": 1003,
  4. "error": "密文校验失败"
  5. }

可能出现的返回id

1001 //参数无效
1002 //appid参数无效
3 //appid过期
1003 //密文校验失败
1004 //用户名不存在或密码错误
0 ////默认的返回值,为0,自增
101 //未知错误

返回参数说明:

data:

参数名 类型 说明
access_token string 登录凭证
refresh_token string 刷新凭证

其它基础返回值请查看相关信息列表

#

  • 验证token接口

请求域名:

请求URL:

POST:/api/v1/check_token

参数:

参数名 是否必须 类型 说明
token string access_token

返回示例:

正确时返回:

  1. {
  2. "state": true,
  3. "error": "默认返回值",
  4. "data":{
  5. "username": "18020119796",
  6. "expire_time": "10000"
  7. }
  8. }

错误时返回:

  1. {
  2. "state": false,
  3. "code": 102,
  4. "error": "Token失效"
  5. }

可能出现的返回id

1001 //参数无效
0 ////默认的返回值,为0,自增
102 //token失效

返回参数说明:

data:

参数名 类型 说明
username string 用户名
expire_time string 过期时间(秒)

成功返回用户名

#

  • 刷新token接口

请求域名:

请求URL:

POST:/api/v1/refresh_token

参数:

参数名 是否必须 类型 说明
refresh_token string refresh_token

返回示例:

正确时返回:

  1. {
  2. "state": true,
  3. "error": "默认返回值",
  4. "data":{
  5. "access_token": "nE97OUonpIIPtfnKYoQBMz94qJDjHDC6",
  6. "refresh_token": "NI1k9Q5zsEZfX2wyhad3PT0i46dcazI1",
  7. "expire_time": "10000",
  8. "username": "18020119796"
  9. }
  10. }

错误时返回:

  1. {
  2. "state": false,
  3. "code": 102,
  4. "error": "Token失效"
  5. }

可能出现的返回id

1001 //参数无效
0 ////默认的返回值,为0,自增
101 //未知错误
102 //token失效

返回参数说明:

data:

参数名 类型 说明
access_token string 登录凭证
refresh_token string 刷新凭证
username string 用户名
expire_time string 过期时间(秒)

备注:

  • 更多返回错误代码请看首页的错误代码描述