## 用户信息

### 基本信息

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

### 接口说明

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

### 接口地址

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

### 请求方式

```
GET
```

### 认证方式

```
Authorization: Bearer access_token
```

### 请求参数

无

### 请求示例

```shell
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(至尊版) | - |

### 响应示例

```json
{
  "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等级名称枚举 |