创建子账号
创建子账号(user/create_child)
描述
用户登录父账号后,通过本接口创建子账户。
仅限于父账号使用。
请求语法
POST /user/create_child HTTP/1.1
Host: acc.qbox.me
Content-Type: application/x-www-form-urlencoded
Authorization: Bearer <AccessToken>
<UserCreateChildRequestParams>
访问权限
可使用账号管理凭证 oauth token。
头部信息
头部名称 | 必填 | 说明 |
---|---|---|
Host | 是 | 固定为acc.qbox.me ,必须以 HTTPS 方式 访问。 |
Content-Type | 是 | 固定为application/x-www-form-urlencoded 。 |
Authorization | 是 | 账号管理凭证。 |
该参数应严格按照账号管理凭证格式进行填充,否则会返回 401 错误码
一个合法的 Authorization 值应类似于:Bearer QNJi_bYJlmO5LeY08FfoNj9w_r7...
|
请求参数
请求参数以表单形式组织,作为请求内容提交,格式如下:
email=<UrlEncodedEmail>&password=<UrlEncodedPassword>
参数名称 | 必填 | 说明 |
---|---|---|
是 | 子账号的注册邮箱。 | |
password | 是 | 子账号的登录密码。 |
响应
响应语法
HTTP/1.1 200 OK
Content-Type: application/json
Cache-Control: no-store
<UserCreateChildResponseContent>
头部信息
头部名称 | 必填 | 说明 |
---|---|---|
Content-Type | 是 | 正常情况下该值将被设为application/json ,表示返回 JSON 格式的文本信息。 |
Cache-Control | 是 | 正常情况下该值将被设为no-store ,表示不缓存。 |
响应内容
■ 如果请求成功,返回包含如下内容的 JSON 字符串(已格式化,便于阅读):
{
"userid": "<UserId string>",
"uid": <UserUuid int64>,
"parent_uid": "<ParentId int64>",
"email": "<UserEmail string>",
"is_disabled": <IsDiabled bool>
}
字段名称 | 必填 | 说明 |
---|---|---|
userid | 是 | 用户注册名,通常是注册邮箱。 |
uid | 是 | 用户 UUID,纯数字。 |
parent_uid | 是 | 父账号的用户 UUID,纯数字。 |
是 | 用户注册邮箱。 | |
is_disabled | 是 | 是否处于禁用状态。 |
■ 如果请求失败,返回包含如下内容的 JSON 字符串(已格式化,便于阅读):
{
"error": "<ErrTitle string>",
"error_code": <ErrCode int>,
"error_description": "<ErrMsg string>"
}
HTTP 状态码 | error_code | error | error_description |
---|---|---|---|
405 | 1 | invalid_request_method | 请求方式错误,非预期的 POST 请求。 |
400 | 2 | invalid_client | client_id, client_secret 参数无效。 |
400 | 3 | invalid_token | 错误的、非预期的 AccessToken 或 RefreshToken。 |
400 | 4 | invalid_email | E-Mail 地址格式不正确。 |
400 | 5 | invalid_grant_type | grant_type 参数值错误或不在服务端所支持的列表中。 |
400 | 6 | invalid_without_params | 缺少相应的必要参数。 |
400 | 7 | invalid_empty_params | 参数的值不能为空。 |
400 | 8 | invalid_bad_request | 错误的请求。 |
401 | 9 | expired_token | 提供的 AccessToken 或 RefreshToken 已过期 (视具体情况而定)。 |
409 | 10 | record_exists | 记录已经存在。 |
401 | 11 | failed_authentication | 验证失败, 比如用户名或密码错误。 |
417 | 12 | failed_request | 请求失败。 |
403 | 13 | unauthorized_client | 应用未授权。 |
400 | 14 | record_not_found | 记录不存在,比如 email 未注册等等。 |
401 | 15 | permission_denied | 缺少操作权限,跟用户类型有关。 |
响应状态码
HTTP 状态码 | 含义 |
---|---|
200 | 授权成功。 |
4xx | 参考上方消息列表。 |
599 | 服务端操作失败。 |
如遇此错误,请将完整错误信息(包括所有 HTTP 响应头部)通过邮件发送给我们。 |
附注
- 子账号创建成功以后处于
启用
状态。
文档反馈
(如有产品使用问题,请 提交工单)