用户模块
获取用户列表
接口
GET https://cloud.minapp.com/userve/v2.2/miniapp/user_profile/
info 该接口支持通过参数 return_total_count 指定是否返回查询对象总数,以协助不关心对象总数只关心查询结果列表的开发者提升接口响应速度。 同时,从 v2.2 版本开始该接口默认不返回查询对象总数,欲获取总数的开发者需要显式指定 return_total_count 参数。
参数说明
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
where | String | N | 查询语句,参数值应经过 JSON 编码为 JSONString 后,再经过 URL 编码 |
order_by | String | N | 以下字段不支持排序:gender, country, province, city, language |
limit | Number | N | 限制返回资源的个数,默认为 20 条,最大可设置为 1000 |
offset | Number | N | 设置返回资源的起始偏移值,默认为 0 |
return_total_count | Number | N | 返回结果 meta 中是否返回 total_count,1 为返回,0 为不返回,默认不返回 |
若开发者只需要获取对象总数,则可以通过设置 limit=1
以及 return_total_count=1
来达到该效果,total_count 可从返回的 meta 中获取
请求示例:
代码示例
返回示例
获取当前登录用户信息
接口
GET https://cloud.minapp.com/userve/v1/user-profile/
返回示例
获取用户详情
接口
GET https://cloud.minapp.com/userve/v2.2/miniapp/user_profile/{{user_id}}/
其中 user_id
即用户 ID
代码示例
返回示例
更新单个用户信息
接口
PUT https://cloud.minapp.com/userve/v2.6/miniapp/user_profile/:id/
其中 :id
是用户在 _userprofile
表中的 id
。
info
v2.6 版本前,数据更新操作会结合用户输入数据以及原有的数据行其余字段数据,使用整个数据对象进行保存;
v2.6 版本后(包含 v2.6),数据更新操作仅会针对用户输入数据对字段进行单独更新。
参数说明
info 参数与更新数据表数据的参数一致,详细说明请查看:数据模块:更新数据。 支持数据原子性更新,详细说明请查看:数据模块:数据原子性更新。
返回示例
状态码说明
200
: 成功。
400
: 字段类型不匹配,更新非自定义字段或不存在的字段。
404
: 用户不存在。
批量修改自定义字段
PUT https://cloud.minapp.com/userve/v2.6/miniapp/user_profile/
info 该接口支持通过参数 return_total_count 指定是否返回待更新对象总数,以协助不关心对象总数只关心数据更新结果的开发者提升接口响应速度。 同时,从 v2.2 版本开始该接口默认不返回待更新对象总数,欲获取总数的开发者需要显式指定 return_total_count 参数。
Query 参数说明
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
where | String | N | 查询语句,参数值应经过 JSON 编码为 JSONString 后,再经过 URL 编码 |
limit | Number | N | 限制单次请求更新的用户数,默认为 20 条,最大可设置为 1000 |
offset | Number | N | 设置更新的偏移值,默认为 0 |
return_total_count | Number | N | 返回结果中是否包含 total_count,1 为包含,0 为不包含,默认不包含 |
info where 字段的详细说明请查看:数据模块:数据操作。
参数说明
info 参数与更新数据表数据的参数一致,详细说明请查看:数据模块:更新数据。 支持数据原子性更新,详细说明请查看:数据模块:数据原子性更新。
代码示例
返回示例
info 返回参数的详细说明请查看:数据模块:同步批量修改数据。
状态码说明
200
: 成功。
400
: 字段类型不匹配,更新非自定义字段或不存在的字段。
401
: 未授权,请检查请求头中的 Authorization 字段是否正确。
修改用户登录信息
接口
PUT https://cloud.minapp.com/userve/v2.2/miniapp/user/account/:id/
其中 :id
是用户在 _userprofile
表中的 id
。
参数说明
Content-Type: application/json
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
username | string | N | 用户名,不区分大小写 |
string | N | 邮箱,不区分大小写 | |
new_password | string | N | 设置用户密码 |
phone | string | N | 新的手机号 |
如果需要为用户强行修改密码, 传入 new_password
即可。 当设置新的手机号时,phone_verified
重置为 false
,需要重新通过验证码进行验证。
如想重置用户的 email/username/phone,可以将 email/username/phone 的值设置为 null。
代码示例
返回示例
返回参数说明
参数 | 类型 | 说明 |
---|---|---|
username | string | 用户名,不区分大小写 |
string | 邮箱,不区分大小写 | |
email_verified | boolean | 用户邮箱是否已激活 |
phone | string | 手机号码 |
phone_verified | boolean | 手机号码是否已经验证 |
状态码说明
200
: 成功。
400
: password 错误、email 不合法、username 或 email 已经存在。
404
: 用户不存在。
Last updated