智汇云-企业数智化核心引擎

# 表单上传（upload）
表单上传类型适用于文件内容可以在一次HTTP请求即可传递完成的场景。

该功能非常适合于在浏览器中使用HTML表单上传资源，或者在不需要处理复杂情况的客户端开发中使用。

*注意：本接口是走原生FORM-POST的方案，如果要走JS异步处理请[使用JS-SDK](/developer/doc?did=WebSDKsyzn "使用JS-SDK")，或者直接把该接口走服务端包装代理。*

## 请求

**请求方式**
POST

**请求语法**

`北京Bucket: up-beijing.oss.yunpan.360.cn      上海Bucket: up-shanghai.oss.yunpan.360.cn`

**表单信息**

| 名称 | 	必填| 说明 |
|--------------|------------------|--------------------------------------|
| token| 是 | 符合上传签名计算规则的一个值 |
| file| 是 | 上传文件 |

## 上传签名

**上传策略格式**
	{
		"bucket", <Bucket string>,
		"object", <Object string>,
		"deadline", <UnixTimestamp uint32>,
		"insertOnly", <InsertOnly, int>
	}
	
**上传策略说明**

| 头部 | 	必填| 说明 |
|--------------|------------------|--------------------------------------|
| bucket| 是 | 空间名称|
| object| 是 | 对象名称 |
| deadline| 是 | 此上传策略的有效期，即在该时间点以前上传完成，建议设置为当前时间+3600s|
| insertOnly| 否 | 默认值为0，表示可以覆盖旧Object；如果设置为1，表示仅能新增，如指定Object存在则上传失败|
**上传签名计算**
1. 将上传策略序列化成JSON格式，比如：

{"bucket":"abcd","object":"hello_world.jpg","deadline":1447215700,"insertOnly":1}
	
2. 将JSON化的上传策略进行 URL安全的Base64 编码（即base64_encode编码后，把加号"+"替换为中划线"-"，把斜杠"/"替换为下划线），上面JSON数据编码后为：

eyJidWNrZXQiOiJhYmNkIiwib2JqZWN0IjoiaGVsbG9fd29ybGQuanBnIiwiZGVhZGxpbmUiOjE0NDcyMTU3MDAsImluc2VydE9ubHkiOjF9
	
3. 使用 SecretKey 和上面编码后的字符串进行 md5 计算，假设 SecretKey 的值为 MY_SECRET_KEY

$sign = md5(eyJidWNrZXQiOiJhYmNkIiwib2JqZWN0IjoiaGVsbG9fd29ybGQuanBnIiwiZGVhZGxpbmUiOjE0NDcyMTU3MDAsImluc2VydE9ubHkiOjF9MY_SECRET_KEY)  //结果为：efeb3c032abe974a5b9e42c582162594

4. 将 AccessKey, 上面的md5值，编码后的上传策略，用冒号连接组成上传签名。假设 AccessKey 的值为
   MY_ACCESS_KEY

$upload_token = MY_ACCESS_KEY:efeb3c032abe974a5b9e42c582162594:eyJidWNrZXQiOiJhYmNkIiwib2JqZWN0IjoiaGVsbG9fd29ybGQuanBnIiwiZGVhZGxpbmUiOjE0NDcyMTU3MDAsImluc2VydE9ubHkiOjF9

**HTTP请求内容大致如下：**

POST http://up-shanghai.oss.yunpan.360.cn
		Content-Type: multipart/form-data; boundary=<Boundary>
		--<Boundary>
		
		Content-Disposition: form-data; name="token"
		<upload_token>
		--<Boundary>
		
		Content-Disposition: form-data; name="file"; filename="[文件名]"
		Content-Type: <MimeType>
		[文件内容]
		--<Boundary>

## 响应
**头部信息**

|头部|必填|说明|
|:--:|:--:|:--:|
|Content-Type|是|该值被设为 `application/json`|
|X-Reqid|否|上传请求唯一ID|
|X-Log|否|请求错误参考信息|

**响应内容**

**如果请求成功返回包含如下内容的JSON字符串（已格式化，便于阅读）**

{
		"bucket": <Bucket string>,
		"object": <Object string>,
		"fsize": <FileSize int>,
		"fhash": <FileHash string>
	}
字段含义如下：

|字段|必填|说明|
|:--:|:--:|:--:|
|bucket|是|bucket名称|
|object|是|object名称|
|fsize|是|文件尺寸，单位：字节（Byte）|
|fhash|是|文件的Hash值|

**如果请求失败，返回包含如下内容的JSON字符串（已格式化，便于阅读）**

{
		"errorCode": "<ErrorCode string>"
		“errorMessage”: "<ErrorMessage string>"
	}
	
字段含义如下：

|字段|必填|说明|
|:--:|:--:|:--:|
|errorCode|是|错误码|
|errorMessage|是|与错误码对应的消息文本|

响应状态码含义如下：

|HTTP状态码|含义|
|:--:|:--:|:--:|
|200|成功|
|400|请求报文格式错误|
|401|请求签名信息错误|

AI大模型

AI平台

AI应用

视频

物联网

数据上云

IoT设备

账号体系

智慧城市

电商视频解决方案

教育

全屋智能

医疗

智能制造

游戏

云存储

电话咨询：

服务咨询

建议反馈

产品与服务

文档与社区

关于我们

关注我们

请您联系我们

小安提醒您

1对1免费 咨询智汇云专属顾问

为您量身定制产品解决方案

1对1免费咨询智汇云专属顾问