Token:login

通过账号密码登陆，返回 Token 信息。

若登录失败，且返回信息中含参数 captcha_token 和 captcha_image，表示下次调用该接口时，需要用户输入图形验证码，并把 captcha_token 和 captcha_code 参数传递到服务端。

HTTP 请求

POST /api/tokens

请求体

请求体类型：application/json

示例

{
  "name": "zdhxiong",
  "password": "7c4a8d09ca3762af61e59520943dc26494f8941b",
  "device": "Xiaomi6",
  "captcha_token": "73687e77c8314821a8a301d96c776f01",
  "captcha_code": "f8h4d"
}

参数说明

参数名	必选	类型	说明
`name`	是	`string`	用户名或邮箱
`password`	是	`string`	经过 hash1 加密后的密码。若你使用的是 mdclub-sdk-js，则 SDK 内部已经实现了 sha1 加密，该参数直接传入明文密码即可。若你直接调用 REST API，则需要自己实现 sha1 加密。
`device`	否	`string`	设备信息
`captcha_token`	否	`string`	图形验证码token。若上一次请求返回了 `captcha_token`，则必须传该参数
`captcha_code`	否	`string`	图形验证码的值。若上一次请求返回了 `captcha_token`，则必须传该参数

响应

Token 信息

示例

{
  "code": 0,
  "data": {
    "token": "13180944453b7d052125486eefabedf9",
    "user_id": 1,
    "device": "Xiaomi6",
    "create_time": 1563512214,
    "update_time": 1563512214,
    "expire_time": 2063512214
  }
}

参数说明

参数名	类型	说明
`code`	`integer`	无任何错误时，状态码为 0
`data.token`	`string`	Token 字符串
`data.user_id`	`integer`	用户ID
`data.device`	`string`	设备信息
`data.create_time`	`integer`	创建时间
`data.update_time`	`integer`	更新时间
`data.expire_time`	`integer`	过期时间