java-web/docs/resources/附件上传接口.md

1. 附件上传

1.1 接口描述

上传图片、视频、压缩文件等。

1.2 请求URL

/v1/attachment

1.3 请求方式

POST

multipart/form-data方式上传文件

1.4 请求头示例

Content-Type: multipart/form-data; boundary=----12256474795412178794287418104

1.6 请求体示例

-----------------------------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

-----------------------------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 响应示例（成功）

{
	"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 响应示例（错误）

{ "code": 500, "msg": "失败" }

1.10 错误响应码参考

更多响应错误码及含义，请参阅API响应码表。

1.11 安全性与认证

1.12 测试环境

访问测试环境以进行接口调试： https://test.apiAddress.com

1.13 版本管理

本API通过URI路径进行版本控制。请在请求URL中包含/v1以使用当前版本。

1.14 更新记录

• 2024-04-29：发布文档初始版本。

1.15 联系支持

如需帮助或对API有任何疑问，请通过电子邮件与我们联系：support@api.com。

1.16 反馈与建议

发现文档问题或有改进建议？请填写反馈表单与我们分享。