APIv2_用户信息 - 17kong/yiqikong-wiki GitHub Wiki

用户信息

请及时更新文档 任何人发现文档和接口不符请及时通知团队维护者

获取单个用户

通用获取仪器控用户接口

GET /user/:id

此处id可以传递仪器控id, 微信id, 或邮箱任意一种

响应

Status: 200 OK
-
{
  "id": 1, // 用户ID
  "gapper_id": 1, // GapperID
  "email": "[email protected]", // 邮箱
  "name": "仪器控", // 用户昵称
  "from": "2010-01-01", // 所在开始时间
  "to": "2018-01-01" // 所在结束时间
}

获取多个用户

通用获取仪器控多用户接口

GET /user

参数

{
  "name": "仪器控", // 用户昵称
  "gender": "male", // 用户性别
  "email": "[email protected]", // 邮箱
  "phone": "1350", // 电话
  "gapper_id": 1, // GapperID
  "sortby": "name", // 排序字段
  "order": "desc", // 排序方式
  "limit": [0, 20], // 分页筛选
}

响应

Status: 200 OK
-
[
  {
    "id": 1, // 用户ID
    "gapper_id": 1, // GapperID
    "email": "[email protected]", // 邮箱
    "name": "仪器控", // 用户昵称
    "from": "2010-01-01", // 所在开始时间
    "to": "2018-01-01" // 所在结束时间
  }
]

添加用户

通用添加仪器控用户接口

POST /user

参数

{
  "name": "仪器控", // 用户昵称
  "email": "[email protected]", // 邮箱
  "code": "1350", // 验证码
  "password": "17kong123456", // 密码
}

响应

Status: 200 OK
-
{
  "id": 1, // 用户ID
  "gapper_id": 1, // GapperID
  "email": "[email protected]", // 邮箱
  "name": "仪器控", // 用户昵称
  "from": "2010-01-01", // 所在开始时间
  "to": "2018-01-01" // 所在结束时间
}
Status: 400 Bad Request
-
"invalid code"
"yiqikong user already exists"
"unable to register on gapper"
"gapper user already exists"