sso.md 10.4 KB

Raw Blame History Permalink



1、登录接口

登录（/login/back）


请求参数 post


参数名称
参数类型
长度
可否为空
示例
默认值
备注


account
String
1-11
否
802654

邮箱/手机号


password
String
1-50
否


密码


area
string
1-10
(国际手机号不可为空，不传默认为86)
86

区号


source
string
1-10
否
"mars"、"now"

标识，用于区分mars和资讯


请求参数示例：

{"account":"13971468726",
 "password":"linlong11",
 "area":"86",
 "source":"mars"
}


响应JSON格式如下所示:

{
  "code": 20101,
  "message": "成功登录",
  "data": {
    "nick": "﹏ζั͡ޓއއއ…",
    "birthday": "1990-11-30",
    "uid": 10893,
    "ssoUid":10987,
    "gender": "1",
    "create_time": 1353515088,
    "mobile_phone": "13971468726",
    "head_pic": "/2012/12/12/21/019a65948847282b366746433fa9b0f185.jpg",
    "real_name": "-Acting Cute ~",
    "email": "qq__F630D4DF9DEDB4DB84F397E2D9DA515B@yohoinc.com"
  }
}


返回码说明：


返回码说明


返回码
说明


20001
成功登录


2、第三方登录接口

第三方登录（/associate/index）


请求参数 post


参数名称
参数类型
长度
可否为空
示例
默认值
备注


type
int

否
4

第三方登录类型


auth
String
1-50
否


第三方登录账号


source
string
1-10
否
"mars"、"now"

标识，用于区分mars和资讯


请求参数示例：

{"type":"4",
 "auth":"F630D4DF9DEDB4DB84F397E2D9DA515B",
 "source":"mars"
}


响应JSON格式如下所示:

{
  "code": 200,
  "message": "成功操作",
  "data": {
    "nick": "﹏ζั͡ޓއއއ…",
    "birthday": "1990-11-30",
    "uid": 10893,
    "ssoUid":10987,
    "gender": "1",
    "create_time": 1353515088,
    "mobile_phone": "13971468726",
    "head_pic": "/2012/12/12/21/019a65948847282b366746433fa9b0f185.jpg",
    "real_name": "-Acting Cute ~",
    "email": "qq__F630D4DF9DEDB4DB84F397E2D9DA515B@yohoinc.com"
  }
}


返回码说明：


返回码说明


返回码
说明


200
成功操作


405
不存在该用户


3、注册接口

注册（/register/back）


请求参数 post


参数名称
参数类型
长度
可否为空
示例
默认值
备注


account
String
1-11
否
802654

邮箱/手机号


password
String
1-50
否


密码


area
string
1-10
(国际手机号不可为空，不传默认为86)
86

区号


source
string
1-10
否
"mars"、"now"

标识，用于区分mars和资讯


client_type
string
1-10
否
"h5"

客户端类型,共有"h5"、"web"、"iphone"、"android"


channel_code
string
1-10
否
"renren"

第三方类型,共有"renren"、"douban"、"sina"、"alipay"、"wechat"、"qq"、"facebook"


普通注册：channel_code传和client_type一样的值;第三方绑定账号注册channel_code传实际的第三方类型

普通请求参数示例：

{"account":"15996238444",
 "password":"11111111",
 "area":"86",
 "source":"mars",
 "client_type":"h5",
 "channel_code":"h5"
}


第三方绑定请求参数示例：

{"account":"15996238444",
 "password":"11111111",
 "area":"86",
 "source":"mars",
 "client_type":"h5",
 "channel_code":"wechat"
}


响应JSON格式如下所示:

{
  "code": 20100,
  "message": "成功注册",
  "data": {
    "nick": "15996238444",
    "birthday": null,
    "uid": 20423864,
    "gender": "3",
    "create_time": 1481795784,
    "mobile_phone": "15996238444",
    "head_pic": null,
    "real_name": null,
    "email": null
  }
}


返回码说明：


返回码说明


返回码
说明


20010
成功注册


4、获取所有口令列表

获取所有口令列表（/userinfo/getAllAccount）


请求参数 post


参数名称
参数类型
长度
可否为空
示例
默认值
备注


uid
int
1-11
否
802654

sso uid


source
string
1-10
否
"mars"、"now"

标识，用于区分mars和资讯


请求参数示例：

{"uid":"1111111",
 "source":"mars"
}


响应JSON格式如下所示:

{
  "code": 200,
  "message": "成功操作",
  "data": {
    "userInfo": {
      "nick": "﹏ζั͡ޓއއއ…",
      "birthday": "1990-11-30",
      "uid": 3603417,
      "gender": "1",
      "create_time": 1353515088,
      "mobile_phone": "13971468726",
      "head_pic": "/2012/12/12/21/019a65948847282b366746433fa9b0f185.jpg",
      "real_name": "-Acting Cute ~",
      "email": "qq__F630D4DF9DEDB4DB84F397E2D9DA515B@yohoinc.com"
    },
    "password": "140c41abbfe9892e9065109b1dd92de2:a0znfrc4Cd0MGTUnX399NEZHLqAp5dpg",
    "list": {
      "1": {
        "auth_id": "qq__F630D4DF9DEDB4DB84F397E2D9DA515B@yohoinc.com",
        "type": 1
      },
      "2": {
        "auth_id": "13971468726",
        "type": 2
      },
      "4": {
        "auth_id": "F630D4DF9DEDB4DB84F397E2D9DA515B",
        "type": 4
      }
    }
  }
}


返回码说明：


返回码说明


返回码
说明


200
成功操作


5、绑定指定类型的口令

绑定指定类型的口令（/userinfo/setauth）


请求参数 post


参数名称
参数类型
长度
可否为空
示例
默认值
备注


uid
int
1-11
否
802654

sso uid


authId
string
1-50
否


绑定账号


type
int

否
4

绑定类型


source
string
1-10
否
"mars"、"now"

标识，用于区分mars和资讯


请求参数示例：

{"uid":1111111,
"authId":"F630D4DF9DEDB4DB84F397E2D9DA515C",
"type":3,
"source":"mars"
}


响应JSON格式如下所示:

{
  "code": 200,
  "message": "成功操作",
  "data": null
}


返回码说明：


返回码说明


返回码
说明


200
成功操作


6、获取指定type指定auth_id的绑定信息

获取指定type指定auth_id的绑定信息（/userinfo/getauth）


请求参数 post


参数名称
参数类型
长度
可否为空
示例
默认值
备注


authId
string
1-50
否


绑定账号


type
int

否
4

绑定类型


source
string
1-10
否
"mars"、"now"

标识，用于区分mars和资讯


请求参数示例：

{
"authId":"13971468726",
"type":2,
"source":"mars"
}


响应JSON格式如下所示:

{
  "code": 200,
  "message": "成功操作",
  "data": {
    "uid": 1111111,
    "create_time": 1353515088,
    "type": 2,
    "authId": "13971468726"
  }
}


返回码说明：


返回码说明


返回码
说明


200
成功操作


7、取消绑定

取消绑定（/userinfo/delauth）


请求参数 post


参数名称
参数类型
长度
可否为空
示例
默认值
备注


uid
int
1-11
否
802654

sso uid


authId
string
1-50
否


绑定账号


type
int

否
4

绑定类型


source
string
1-10
否
"mars"、"now"

标识，用于区分mars和资讯


type：手机或者邮箱
抛出异常，不允许取消手机或邮箱的绑定

请求参数示例：

{"uid":1111111,
"authId":"F630D4DF9DEDB4DB84F397E2D9DA515C",
"type":3,
"source":"mars"
}


响应JSON格式如下所示:

{
  "code": 200,
  "message": "成功操作",
  "data": null
}


返回码说明：


返回码说明


返回码
说明


200
成功操作


8、获取用户信息

获取用户信息（/userinfo/getUserInfo）


请求参数 post


参数名称
参数类型
长度
可否为空
示例
默认值
备注


uid
int
1-11
是
802654

sso uid


account
String
1-11
是
802654

邮箱/手机号


type
int

否
4

绑定类型


area
string
1-10
(国际手机号不可为空，不传默认为86)
86

区号


source
string
1-10
否
"mars"、"now"

标识，用于区分mars和资讯


account与uid必须传递一个,两者都传,以uid为准

请求参数示例：

{"account":"13971468726",
 "area":"",
 "type":2,
 "source":"mars"
}


响应JSON格式如下所示:

{
  "code": 200,
  "message": "成功操作",
  "data": {
    "nick": "﹏ζั͡ޓއއއ…",
    "birthday": "1990-11-30",
    "uid": 1111111,
    "gender": "1",
    "create_time": 1353515088,
    "mobile_phone": "13971468726",
    "head_pic": "/2012/12/12/21/019a65948847282b366746433fa9b0f185.jpg",
    "real_name": "-Acting Cute ~",
    "email": "qq__F630D4DF9DEDB4DB84F397E2D9DA515B@yohoinc.com"
  }
}


返回码说明：


返回码说明


返回码
说明


200
成功操作


9、更新用户资料（已废弃，返回成功）

更新用户资料（/userinfo/update）


请求参数 post


参数名称
参数类型
长度
可否为空
示例
默认值
备注


响应JSON格式如下所示:

{
  "code": 20020,
  "message": "成功更新用户资料",
  "data":null
}


返回码说明：


返回码说明


返回码
说明


20020
成功更新用户资料


10、更新密码

更新密码（/userinfo/changepwd）


请求参数 post


参数名称
参数类型
长度
可否为空
示例
默认值
备注


uid
int
1-11
否
802654

sso uid


password
String
1-50
否


密码


type
int

否
4

绑定类型


source
string
1-10
否
"mars"、"now"

标识，用于区分mars和资讯


account与uid必须传递一个,两者都传,以uid为准

请求参数示例：

{"uid":"1111111",
 "password":"linlong11",
 "type":2,
 "source":"mars"
}


响应JSON格式如下所示:

{
  "code": 200,
  "message": "成功操作",
  "data": ""
}


返回码说明：


返回码说明


返回码
说明


200
成功操作


错误码说明：


错误码说明


错误码
说明


500
系统错误


500001
缺少参数


500002
参数错误


50100
该用户已存在


50101
该用户不存在


50102
该用户已被禁用


50103
该用户未登录


50200
密码不正确


50201
密码不合法,至少6个字符


50300
账号不合法


50301
无效的账号类型


50302
绑定账号失败


50303
该账号不允许解除绑定


50304
该账号已存在


50400
更新用户资料失败