mirror of
https://github.com/truewhile/MeBox.git
synced 2026-09-28 03:06:38 +08:00
truewhile
141 lines
5.5 KiB
Markdown
141 lines
5.5 KiB
Markdown
## 用户信息
|
|
|
|
### 基本信息
|
|
|
|
| 属性 | 内容 |
|
|
|:---------|:------------------------------|
|
|
| 接口名称 | 用户信息 |
|
|
| 接口版本 | 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等级名称枚举 |
|