menu MDClub API 文档

Token:login

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

若登录失败,且返回信息中含参数 captcha_tokencaptcha_image, 表示下次调用该接口时,需要用户输入图形验证码,并把 captcha_tokencaptcha_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

过期时间