用户
用户(user)对象结构
字段
参数 | 类型 | 说明 |
---|---|---|
user_id | integer | 用户 ID |
avatar | string | 用户头像 |
_username | string | 用户名 |
_email | string | 用户邮件地址 |
_email_verified | boolean | 用户邮件地址是否已经验证 |
_provider | object | 用户在平台方的用户信息(见 |
country | string | 用户所在的国家 |
province | string | 用户所在的省份 |
city | string | 用户所在城市 |
gender | string | 用户的性别,值为 1 时是男性,值为 2 时是女性,值为 0 时是未知 |
示例
用户注册
接口
POST /hserve/v2.1/register/:register-type/
:register-type 有两种:
email: 通过邮箱注册
username: 通过用户名注册
{% tabs createTableEmail="通过邮箱注册", createTableUsername="通过用户名注册" %}
请求参数
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
string | 是 | 邮箱地址 | |
password | string | 是 | 密码 |
请求示例
请求参数
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
username | string | 是 | 用户名 |
password | string | 是 | 密码 |
请求示例
返回参数说明
参数 | 类型 | 说明 |
---|---|---|
token | string | User authentication token |
expires_in | integer | token 的有效时间,最长为 30 天,单位:秒;token 过期时间 = 注册时间 + token 有效时间 |
其余字段可参考用户(user)
状态码说明
201
: 注册成功
400
: 参数错误
用户登录
接口
POST /hserve/v2.1/login/:login-type/
:login-type 有两种:
email: 通过邮箱登陆
username: 通过用户名登陆
{% tabs createTableEmailLogin="通过邮箱登陆", createTableUsernameLogin="通过用户名登陆" %}
请求参数
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
string | 是 | 邮箱地址 | |
password | string | 是 | 密码 |
请求示例
请求参数
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
username | string | 是 | 用户名 |
password | string | 是 | 密码 |
请求示例
返回示例
参数 | 类型 | 说明 |
---|---|---|
token | string | User authentication token |
expires_in | integer | token 的有效时间,最长为 30 天,单位:秒;token 过期时间 = 登录时间 + token 有效时间 |
其余字段可参考用户(user)
状态码说明
201
: 登陆成功
400
: 参数错误
查询用户信息
接口
GET /hserve/v2.2/user/info/:user_id/
:user_id 为用户(user)中的 user_id
请求示例
返回示例
字段详细说明请参考用户(user)
状态码说明
200
: 查询成功
401
: 未授权,请检查请求头中的 Authorization 字段是否正确
404
: 用户不存在
批量查询用户信息
接口
GET /hserve/v2.2/user/info/
info 该接口支持通过参数 return_total_count 指定是否返回查询对象总数,以协助不关心对象总数只关心查询结果列表的开发者提升接口响应速度。 同时,从 v2.2 版本开始该接口默认不返回查询对象总数,欲获取总数的开发者需要显式指定 return_total_count 参数。
若开发者只需要获取对象总数,则可以通过设置 limit=1
以及 return_total_count=1
来达到该效果,total_count 可从返回的 meta 中获取
请求示例:
请求示例
返回示例
字段的详细请参考用户(user)
状态码说明
200
: 查询成功
401
: 未授权,请检查请求头中的 Authorization 字段是否正确
404
: 用户不存在
用户邮箱验证
接口
POST /hserve/v2.0/user/email-verify/
请求示例
返回示例
状态码说明
201
: 成功发送验证邮件
400
: 发送失败
401
: 未授权,请检查请求头中的 Authorization 字段是否正确
用户登出
接口
POST /hserve/v2.0/session/destroy/
请求示例
返回示例
状态码说明
201
: 登出成功
401
: 未授权,请检查请求头中的 Authorization 字段是否正确
修改用户信息
可更改密码、用户名、邮箱、手机号
接口
PUT /hserve/v2.1/user/account/
请求参数
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
string | 否 | 新的邮箱地址 | |
username | string | 否 | 新的用户名 |
phone | string | 否 | 新的手机号 |
password | string | 否 | 旧密码 |
new_password | string | 否 | 新密码 |
如果选择修改密码, 必须同时传入 password
和 new_password
。 当设置新的手机号时,phone_verified
重置为 false
,需要重新通过验证码进行验证。
如想重置用户的 email/username/phone,可以将 email/username/phone 的值设置为 null。
请求示例
返回示例
返回字段说明
参数 | 类型 | 说明 |
---|---|---|
string | 目前的邮箱 | |
email_verified | boolean | 邮箱是否已经验证 |
username | string | 目前的用户名 |
phone | string | 手机号码 |
phone_verified | boolean | 手机号码是否已经验证 |
状态码说明
200
: 更新成功
400
: 参数错误(可能是旧密码错误)
401
: 未授权,请检查请求头中的 Authorization 字段是否正确
用户通过邮箱重置密码
接口
POST /hserve/v2.0/user/password/reset/
请求参数
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
string | 是 | 需要重置密码的用户的邮箱地址 |
请求示例
返回示例
状态码说明
201
: 已向用户发送密码重置邮件
400
: 参数错误
404
: 用户不存在
Last updated