Skip to content
markzhai edited this page Sep 27, 2016 · 2 revisions

用户系统

用户系统的API文档

响应特殊说明

字段 类型 描述
gender int 0默认,1男,2女

登录接口

请求方式形式:

POST /user/login

请求参数

名字 类型 描述
username String 用户名
password String 密码

成功样例

{
  "status_no":0,
  "status_msg": "登录成功",
  "data":{
    "token":"xxxxx",
    "userId":"xxxxx",
  }
}

第三方登录

请求方式形式:

POST /user/thirdLogin

请求参数

名字 类型 描述
platform String 平台: WeiXin,WeiBo,QQ
code String 授权码
expires_in String access_token(生命周期(秒))
refresh_token String refresh_token
openid String openid

成功样例

{
  "status_no":0,
  "status_msg": "登录成功",
  "data":{
    "token":"xxxxx",
    "user_id":"xxxxx",
  }
}

失败样例

{
  "status_no": -1020,
  "status_msg": "请前往绑定账号",
  "data":{

  }
}

注册

请求方式形式:

POST /user/register

请求参数

名字 类型 描述
zone String 区号,默认为86
username String 手机号码
password String 密码
code String 手机验证码

成功样例

{
  "status_no": 0,
  "status_msg": "注册成功",
  "data": {
    "token": "xxxxxxxxx",
    "userId": "xxxxxx"
  }
}

失败样例

{
    "status_no": -1,
    "status_msg": "该账号已注册,请更换"
}

完善个人信息

请求方式形式:

POST /user/perfect

请求参数

名字 类型 描述
uid String 用户账号
nickname String 用户昵称
avatar String 头像
gender int 用户性别(0:未知,1:男,2:女)

响应

成功样例

{
  "status_no": 0,
  "status_msg": ""
}

用户资料提交/修改接口

请求方式形式:

POST /user/updateProfile

请求参数

名字 类型 描述
uid String 用户账号
nickname String 用户昵称
avatar String 头像
age int 年龄
gender int 用户性别(0:未知,1:男,2:女)
age int 用户年龄
location String 地区拼接完的字段
website String 个人站点
bio String 个人介绍

响应

成功样例

{
  "status_no": 0,
  "status_msg": ""
  "data": {
    "uid":"asdasdasd12312",
    "username":"18767111111",
    "nickname":"Abner",
    "age":18,
    "gender":0,
    "avatar":"http://xxxxxx.png",
    "location":"上海 徐汇区",
    "website":"http://blog.zhaiyifan.cn",
    "bio":"大地主"
  }
}

修改密码接口

请求方式形式:

POST /user/changePassword

请求参数

名字 类型 描述
username String 用户名
password String 旧密码
new_password String 新密码

响应

成功样例

{
  "status_no":0,
  "status_msg":"xxxxxxx",
  "data":{
    "token": "xxxxxxxxx",
    "userId": "xxxxxx"
  }
}

失败样例

{
  "status_no":-1,
  "status_msg":"xxxxxxx"
}

获取用户信息

请求方式形式:

POST /user/profile

请求参数

名字 类型 描述
uid String user id

成功样例

{
  "statusCode": 0,
  "statusMessage": "",
  "data": {
    "uid": 1,
    "nickname": "MarkZhai",
    "avatar": null,
    "bio": null,
    "location": null,
    "website": null,
    "role": 3,
    "age": 0,
    "gender": 0,
    "registerAt": 1474875968907,
    "updatedAt": 1474875968907
  },
  "timestamp": 1474876764613
}