接口URL
验证方式
未提供 Authorization 则视为游客上传。
📤 公共请求 headers
| 字段 | 类型 | 说明 |
|---|---|---|
| Authorization | String | Bearer {token} |
| *Accept | String | application/json |
📥 公共响应 headers
| 字段 | 类型 | 说明 |
|---|---|---|
| X-RateLimit-Limit | Integer | 一分钟请求配额 |
| X-RateLimit-Remaining | Integer | 剩余配额 |
🔁 响应状态码
| 状态码 | 说明 |
|---|---|
| 401 | 未登录/授权失败 |
| 403 | 权限不足/接口关闭 |
| 429 | 请求受限 |
| 500 | 服务端异常 |
* 红色星号为必传参数
↘︎ 返回参数
| 字段 | 类型 | 说明 |
|---|---|---|
| status | Boolean | 状态 |
| message | String | 描述 |
| data | Object | 数据 |
| username | String | 用户名 |
| name | String | 昵称 |
| avatar | String | 头像地址 |
| String | 邮箱 | |
| capacity | Float | 总容量 |
| size | Float | 已使用 |
| url | String | 个人主页 |
| image_num | Integer | 图片数 |
| album_num | Integer | 相册数 |
| registered_ip | String | 注册IP |
🔍 请求参数 (Query)
| 字段 | 类型 | 说明 |
|---|---|---|
| q | String | 筛选关键字 |
📦 返回参数
| 字段 | 类型 | 说明 |
|---|---|---|
| status | Boolean | 状态 |
| message | String | 描述 |
| data | Object | 数据 |
| strategies | Object[] | 策略数组 |
| id | Integer | 策略ID |
| name | String | 策略名称 |
请求参数 (Body)
| 字段 | 类型 | 说明 |
|---|---|---|
| *num | Integer | 最大100 |
| *seconds | Integer | 最大2626560 |
返回参数
| 字段 | 类型 | 说明 |
|---|---|---|
| tokens | Object[] | 列表 |
| token | String | 临时token |
| expired_at | String | 到期时间 |
Headers
| 字段 | 类型 | 说明 |
|---|---|---|
| *Content-Type | String | multipart/form-data |
请求参数 (Body)
| 字段 | 类型 | 说明 |
|---|---|---|
| *file | File | 图片文件 |
| token | String | 临时Token |
| permission | Integer | 1公开/0私有 |
| strategy_id | Integer | 储存策略ID |
| album_id | Integer | 相册ID |
| expired_at | String | 过期时间 |
返回参数 (部分) 详见文档
请求参数: page, order, permission, album_id, q
路径参数: *key (String)
请求参数 Query: page, order (newest/earliest/most/least), q
返回参数包含 id, name, intro, image_num 等
路径参数: *id (String) 相册自增ID
返回标准 status/message/data