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

# 表单上传（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|请求签名信息错误|

存储服务

视觉分析

内容审核

人脸与人体识别

OCR识别

图像技术

AI市场

网络加速

基础组件

视频应用

企业工具

视频应用

视频工具

物联网平台

应用开发

研发效能

云计算

大数据

容器服务

AI开发平台

视频

物联网

数据上云

IoT设备

账号体系

智慧城市

电商视频解决方案

教育

全屋智能

医疗

智能制造

游戏

云存储

电话咨询：

热门产品

帮助文档

服务条款

关注或联系我们

请您联系我们

小安提醒您

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

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

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