MeBox/115doc/115开放平台/API列表/用户管理/用户信息.md

用户信息

基本信息

属性	内容
接口名称	用户信息
接口版本	v1.0
接口路径	/user/info
请求方法	GET
接口状态	生产环境

接口说明

获取当前授权用户的基本信息、网盘空间信息、VIP 等级信息以及第三方畅用权益信息。

接口地址

https://proapi.115.com/open/user/info

请求方式

GET

认证方式

Authorization: Bearer access_token

请求参数

无

请求示例

curl 'https://proapi.115.com/open/user/info' \
  -H 'Authorization: Bearer <ACCESS_TOKEN>'

响应字段说明

字段	类型	描述
state	boolean	状态码，是表示成功，否表示异常
message	string	异常信息
code	int	异常码
data	object	响应数据
data.user_id	int	用户115账号
data.user_name	string	用户名称
data.user_face_s	string	小尺寸用户头像
data.user_face_m	string	中尺寸用户头像
data.user_face_l	string	大尺寸用户头像
data.rt_space_info	object	用户实时空间信息
data.rt_space_info.all_total	object	用户总空间
data.rt_space_info.all_total.size	int	用户总空间大小，单位为字节
data.rt_space_info.all_total.size_format	string	用户总空间大小，格式化文本
data.rt_space_info.all_remain	object	用户剩余空间
data.rt_space_info.all_remain.size	int	用户剩余空间大小，单位为字节
data.rt_space_info.all_remain.size_format	string	用户剩余空间大小，格式化文本
data.rt_space_info.all_use	object	用户已使用空间
data.rt_space_info.all_use.size	int	用户已使用空间大小，单位为字节
data.rt_space_info.all_use.size_format	string	用户已使用空间大小，格式化文本
data.vip_info	object	用户 VIP 等级信息
data.vip_info.level_name	string	VIP 等级名称，见下方枚举表格
data.vip_info.expire	int	VIP 过期时间戳，无 VIP 时为 0
data.vip_info.tp_rights	object	第三方畅用权益信息
data.vip_info.tp_rights.is_tp_rights	int	是否具有当前应用的第三方畅用权益：0-否 1-是
data.vip_info.tp_rights.tp_rights_time	int	第三方畅用权益过期时间戳，无有效权益时为 0

响应的 data.vip_info.level_name 字段枚举

值	说明	备注
原石会员	原石用户	无有效 VIP 等级时的服务端固定返回值
尝鲜VIP	尝鲜VIP	-
体验VIP	体验VIP	-
月费VIP	月费VIP	-
年费VIP	年费VIP	-
长期VIP(高级版)	长期VIP(高级版)	-
长期VIP(特级版)	长期VIP(特级版)	-
长期VIP(超级版)	长期VIP(超级版)	-
长期VIP(至尊版)	长期VIP(至尊版)	-

响应示例

{
  "state": true,
  "message": "",
  "code": 0,
  "data": {
    "user_id": 0,
    "user_name": "",
    "user_face_s": "",
    "user_face_m": "",
    "user_face_l": "",
    "rt_space_info": {
      "all_total": {
        "size": 0,
        "size_format": ""
      },
      "all_remain": {
        "size": 0,
        "size_format": ""
      },
      "all_use": {
        "size": 0,
        "size_format": ""
      }
    },
    "vip_info": {
      "expire": 0,
      "level_name": "原石会员",
      "tp_rights": {
        "is_tp_rights": 0,
        "tp_rights_time": 0
      }
    }
  }
}

注意事项

• access_token 决定当前用户和开放应用，接口不接收用户账号请求参数。
• rt_space_info 为实时空间数据，all_use 由总空间减去剩余空间计算得出。
• 请妥善保管 access_token，不要在日志或客户端可见信息中输出。

修改历史

修改时间	修改说明
2025年04月01日(周二) 00:00:00	创建文档
2026年08月18日(周二) 14:40:25	更新四种长期VIP等级名称枚举