账户财务

  • 账户财务 > 使用文档 > 获取账户信息和权限

    获取账户信息和权限

    最近更新时间: 2017-02-21 15:41:25

    描述

    用户登录后,通过本接口获取账户信息。

    请求语法

    POST /user/info HTTP/1.1
    Host: acc.qbox.me
    Content-Type: application/x-www-form-urlencoded
    Authorization: Bearer <AccessToken>
    
    <UserInfoRequestParams>
    

    访问权限

    请使用账号管理凭证 oauth token。

    头部信息

    头部名称 必填 说明
    Host 固定为acc.qbox.me,必须以 HTTPS 方式 访问
    Content-Type 固定为application/x-www-form-urlencoded
    Authorization 账号管理凭证
    该参数应严格按照账号管理凭证格式进行填充,否则会返回 401 错误码
    一个合法的 Authorization 值应类似于:Bearer QNJi_bYJlmO5LeY08FfoNj9w_r7...

    请求参数

    无。

    响应

    响应语法

    HTTP/1.1 200 OK
    Content-Type: application/json
    Cache-Control: no-store
    
    <UserInfoResponseContent>
    

    头部信息

    头部名称 必填 说明
    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,纯数字。
    email 用户注册邮箱。
    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 参考上方http状态列表。
    599 服务端操作失败。

    如遇此错误,请将完整错误信息(包括所有 HTTP 响应头部)通过邮件发送给我们。

    以上内容是否对您有帮助?
  • Qvm free helper
    Close