上传

文件上传接口，用于上传文件。

危险

文件相关的接口必须遵循安全规范，参考：

文件上传

与普通的 json 形式的接口略有不同，文件上传接口使用 multipart/form-data 形式的 form 表单提交。

http request

POST /file-service/api/upload HTTP/1.1
Host: test-fire-api.ice.run
accept: */*
Content-Type: multipart/form-data; boundary=WebAppBoundary
X-Client: 100000000000000000
X-Security: RSA
X-Sign: NBUfOveRqBqVDtO0f87XMd4pA+6RbavCXM9iqJtgxGMglnQkQ4X49tuiyX05j+iUgcvUOOo6/3GTDDo3A/dR45okDtdTSe5M2piLleNZBDKWdc33Ts9oPdfaq7iH9LrLr1xNDt67Y80oV/bMSzWSpMu37jChg/gbl2221pXbtBE=
X-Hash: KPioxyL0VowZWHrh8+5K7AtSUNd4J1VBHy4afyW/1lOrj9BQ26/4FgW0RhdHq3w9xdmcwUnMxwIAaw4DW4qiBvLF1PJZEzZ/CtVFjMgVWjT7MZbjaBk1W5hr+eP7ItLEblxp7wV/odZw56Y91dfa5zibhcHTTOjizj5tQol9cVE=
X-Time: Mon, 20 May 2024 09:50:41 GMT
X-Trace: 6266c110c07a4e79a17b98321ae9e801

--WebAppBoundary
Content-Disposition: form-data; name="hash"

5feceb66ffc86f38d952786c6d696c79c2dbc239dd4e91b46729d73a27fb57e9
--WebAppBoundary
Content-Disposition: form-data; name="file"; filename="0.txt"

0
--WebAppBoundary--

请求参数:

参数名称	参数说明	请求类型	数据类型	是否必须	示例参数
X-Security	安全模式，固定值 RSA	header	string(16)	true	RSA
X-Client	服务商编号	header	string(18)	true	222222222222222222
X-Sign	X-Hash 的签名	header	string(64)	true	4ea5c508...
X-Time	请求时间 RFC-1123	header	string(32)	true	Mon, 18 Jul 2022 07:15:24 GMT
X-Trace	链路追踪号，参考 Security - 安全	header	string(64)	true	207d889f9f6b4b18bfada6894a12267d
X-Hash	File Hash 的密文	header	string(128)	true	f7522196...
hash	File Hash (sha-256)	query	string(64)	true	244e756b...
file	File 文件	query	file(1M)	true

提示

hash = file 的 sha-256
X-Hash = hash 的加密
X-Sign = X-Hash 的签名
X-* 都放到 header 中
hash 和 file 放到 multipart/form-data 形式的 form 表单中

响应参数:

参数名称	参数说明	类型
id	id	string
code	文件 code	string
name	文件名	string
origin	源文件名	string
type	文件类型	string
size	文件大小	integer(int64)
path	路径	string
url	预览地址	string

响应示例:

{
  "data": {
    "id": "1",
    "code": "1",
    "name": "1",
    "origin": "logo.png",
    "type": "image/png",
    "size": 1,
    "path": "2020/02/20",
    "url": "https://test-fire.ice.run/file-service/api/view?id=1&code=1"
  }
}

危险

服务器限制文件大小为 1M ，如果大于此阈值，请尝试先压缩后上传。

代码示例

在文档的后续章节中，会提供一些主流的编程语言的代码示例，以便开发人员更好地理解和实现文件上传的加密解密加签验签。

如果需要更多其它语言的代码示例，可以联系我司技术支持。

参考下一章节：Code-upload

文件上传​

代码示例​

文件上传

代码示例