用户登陆 | potato cloud开放文档

# 用户登陆

# 简要描述

用户登陆接口，基于auth2开发，用户令牌过期日7天

# 请求URL

/api/login

# 请求头

参数名	必选	类型	说明
Content-Type	是	string	此参数必传，当请求数据非json时此参数传对应格式如（multipartform-data，application/x-www-form-urlencoded，等）是json请传application/json
askKey	是	string	此参数必传,验证app的令牌
sign	否	string	此参数如果在app设置开启了验签是必传
time	否	string	当开启验签时，此参数为必传
apiUserToken	否	string	用户令牌
nonce	否	string	随机字符串(当开启V3验签此参数必传，且2分钟内不允许重复)

# 请求方式

get 或者 post

# 参数

参数名	必选	类型	说明
userNumber	是	string	用户名
passWord	是	string	密码
code	否	string	验证码(app设置验证码登陆开启状态时必传)
uuid	否	string	uuid(app设置验证码登陆开启状态时必传)

# 请求

get:
/api/login?userNumber=12345&passWord=123456

post:
{
 "userNumber": "12345",
  "passWord": "123456"
}

1
2
3
4
5
6
7
8

# 返回示例

{
    "code": "200",
    "message": "",
    "status": true,
    "data": {
        "apiUserToken": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJhcHBJZCI6MSwiZ2V0TWFuYWdlbWVudElkIjo2NDU0MzE5NjkzMzUzMDAwOTYsIlRJTUUiOjE2NTM5NjcwNTU3Nzh9.L1ERGlGSdJZcq1FqF7fZfWW0PHL40ZfeNhtBJjXFwK0"
    },
    "pc": null
}

1
2
3
4
5
6
7
8
9

# 返回参数说明

参数名	类型	说明
code	string	状态码200成功403权限异常或登陆超时，500请求异常
apiUserToken	string	用户令牌，验证用户信息必传，处理注册登陆发送验证码接口其余均要传该参数

# 备注

更多返回错误代码请看首页的错误代码描述

← 用户注册V2 查询用户详情 →