2024-12-02 08:00:52 +08:00
|
|
|
|
## 1. 附件上传
|
|
|
|
|
|
|
|
|
|
|
|
### 1.1 接口描述
|
|
|
|
|
|
上传图片、视频、压缩文件等。
|
|
|
|
|
|
### 1.2 请求URL
|
2024-12-04 09:41:10 +08:00
|
|
|
|
`/v1/attachment`
|
2024-12-02 08:00:52 +08:00
|
|
|
|
|
|
|
|
|
|
### 1.3 请求方式
|
|
|
|
|
|
**POST**
|
|
|
|
|
|
|
|
|
|
|
|
multipart/form-data方式上传文件
|
|
|
|
|
|
|
|
|
|
|
|
### 1.4 请求头示例
|
|
|
|
|
|
```http
|
|
|
|
|
|
Content-Type: multipart/form-data; boundary=----12256474795412178794287418104
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
### 1.6 请求体示例
|
|
|
|
|
|
```http
|
|
|
|
|
|
-----------------------------12256474795412178794287418104
|
|
|
|
|
|
Content-Disposition: form-data; name="type"
|
|
|
|
|
|
|
|
|
|
|
|
public/image
|
|
|
|
|
|
-----------------------------12256474795412178794287418104
|
|
|
|
|
|
Content-Disposition: form-data; name="file"; filename="2024-03-18_22-06.png"
|
|
|
|
|
|
Content-Type: image/png
|
|
|
|
|
|
这里是文件内容...
|
|
|
|
|
|
-----------------------------12256474795412178794287418104
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
```http
|
|
|
|
|
|
-----------------------------35576727471291609851653063070
|
|
|
|
|
|
Content-Disposition: form-data; name="type"
|
|
|
|
|
|
attachment
|
|
|
|
|
|
-----------------------------35576727471291609851653063070
|
|
|
|
|
|
Content-Disposition: form-data; name="file"; filename="paopao.zip"
|
|
|
|
|
|
Content-Type: application/zip
|
|
|
|
|
|
这里是文件内容...
|
|
|
|
|
|
-----------------------------35576727471291609851653063070
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
### 1.7 返回参数说明
|
|
|
|
|
|
| 参数名称 | 必填 | 数据类型 | 约束条件 | 描述 |
|
|
|
|
|
|
|------| ---- | -------- | -- |-----------|
|
|
|
|
|
|
| code | 是 | 整型 | | 错误码，0表示成功 |
|
|
|
|
|
|
| msg | 否 | 字符串 | | 错误信息描述 |
|
|
|
|
|
|
| data | 否 | json | | 具体业务数据 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
data结构说明：
|
|
|
|
|
|
|
|
|
|
|
|
| 参数名称 | 必填 | 数据类型 | 约束条件 | 描述 |
|
|
|
|
|
|
|-------| ---- | -------- |------|-----------|
|
|
|
|
|
|
| | | | | |
|
|
|
|
|
|
|
|
|
|
|
|
### 1.8 响应示例（成功）
|
|
|
|
|
|
|
|
|
|
|
|
```json
|
|
|
|
|
|
{
|
|
|
|
|
|
"code": 0,
|
|
|
|
|
|
"msg": "success",
|
|
|
|
|
|
"data": {
|
|
|
|
|
|
"user_id": 100066,
|
|
|
|
|
|
"file_size": 249763,
|
|
|
|
|
|
"img_width": 0,
|
|
|
|
|
|
"img_height": 0,
|
|
|
|
|
|
"type": 1,
|
|
|
|
|
|
"content": "http://60.204.241.255:8008/oss/paopao/public/image/4f/77/ec/5f/85ad-4189-887d-785cac178e21.png"
|
|
|
|
|
|
}
|
|
|
|
|
|
}
|
|
|
|
|
|
```
|
|
|
|
|
|
### 1.9 响应示例（错误）
|
|
|
|
|
|
```json
|
|
|
|
|
|
{ "code": 500, "msg": "失败" }
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
### 1.10 错误响应码参考
|
|
|
|
|
|
更多响应错误码及含义，请参阅[API响应码表](URL/for/api/responseCode/table)。
|
|
|
|
|
|
|
|
|
|
|
|
### 1.11 安全性与认证
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
### 1.12 测试环境
|
|
|
|
|
|
访问测试环境以进行接口调试：
|
|
|
|
|
|
[https://test.apiAddress.com](https://test.apiAddress.com)
|
|
|
|
|
|
|
|
|
|
|
|
### 1.13 版本管理
|
|
|
|
|
|
本API通过URI路径进行版本控制。请在请求URL中包含`/v1`以使用当前版本。
|
|
|
|
|
|
|
|
|
|
|
|
### 1.14 更新记录
|
|
|
|
|
|
- **2024-04-29**：发布文档初始版本。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
### 1.15 联系支持
|
|
|
|
|
|
如需帮助或对API有任何疑问，请通过电子邮件与我们联系：[support@api.com](mailto:support@api.com)。
|
|
|
|
|
|
|
|
|
|
|
|
### 1.16 反馈与建议
|
|
|
|
|
|
发现文档问题或有改进建议？请填写[反馈表单](https://forms.api.com/feedback)与我们分享。
|
|
|
|
|
|
|
