用户体系文档
官方文档 (参见用户快速参考章节和用户管理章节)
API基础URL: https://api.bmob.cn
Bomb提供的最基础的用户体系
Bomb提供了一个一般性的用户体系,使用用户名(username)和密码(password)来代表一个用户。并提供了基本的用户操作,例如最基本的注册、登录和查询等。
Bomb还提供了一些常用的其它功能,例如:
- 邮箱验证
- 使用手机号一键注册或登录
- 密码重置
- 三方登录支持
- 用户权限管理
首先,让我们来使用Bomb完成最简单的用户体系,只使用最基础的注册和登录功能。
默认提供的用户表 _User:
名称 | 类型 | 必要性 | 描述 ----|------|--------|------ objectId | String | 自动创建 | 主键,唯一ID。 username | String | 必需 | 用户名。 password | String | 必需 | 密码。 mobilePhoneNumberVerified | Boolean | 可选 | 电话号是否验证 mobilePhoneNumber | String | 可选 | 电话号码 emailVerified | Boolean | 可选 | 邮箱是否验证 email | String | 可选 | 邮箱地址 authData | authData | 可选 | 第三方服务的授权信息,用于第三方登录 createAt | Date | 自动创建 | 创建日期 updatedAt | Date | 自动创建 | 更新日期 ACL | ACL | 可选 | Access Control List:访问控制列表,用于数据权限控制
注册用户
请求:
地址 : https://api.bmob.cn/1/users
方法 : POST
请求头 :
X-Bmob-Application-Id: Your Application ID
X-Bmob-REST-API-Key: Your REST API Key
Content-Type: application/json
请求体 :
{
"username" : username, // 用户名
"password" : password // 密码
}
响应:
响应码 : 201 Created
响应体 :
{
"createdAt": YYYY-mm-dd HH:ii:ss, // 用户注册时间
"objectId": objectId, // 用户唯一Id
"sessionToken": sessionToken // 用来认证更新或删除用户的请求
}
登录用户
请求:
地址 : https://api.bmob.cn/1/login
方法 : GET
请求头 :
X-Bmob-Application-Id: Your Application ID
X-Bmob-REST-API-Key: Your REST API Key
Content-Type: application/json
请求体 :
// URL编码参数
"username"=username
"password"=password
响应:
响应码 : 200 OK
响应体 :
{
"username": username, // 登录用户名称
"createdAt": YYYY-mm-dd HH:ii:ss, // 用户创建时间
"updatedAt": YYYY-mm-dd HH:ii:ss, // 用户更新时间
"objectId": objectId, // 用户唯一Id
"sessionToken": sessionToekn // 用来认证更新或删除用户的请求
}