服务端 API/审批/原生审批文件/上传文件
# 上传文件

当审批表单中有图片或附件控件时，开发者需在创建审批实例前通过审批上传文件接口将文件上传到审批系统，且附件上传大小限制为50M，图片上传大小为10M。

## 请求

基本 |  
---|---
HTTP URL | https://www.larksuite.com/approval/openapi/v2/file/upload
HTTP Method | POST
支持的应用类型 | Custom App、Store App
权限要求<br>**调用该 API 所需的权限。开启其中任意一项权限即可调用** | 访问审批应用(approval:approval:readonly)

### 请求头

名称 | 类型 | 必填 | 描述
---|---|---|---
Authorization | string | 是 | `tenant_access_token`<br>**值格式**："Bearer `access_token`"<br>**示例值**："Bearer t-7f1bcd13fc57d46bac21793a18e560"<br>[了解更多：如何选择与获取 access token](https://open.larksuite.com/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-choose-which-type-of-token-to-use)
Content-Type | string | 否 | 不支持用户指定 content-type，填写该参数可能会报错

### 请求体

| 名称         | 类型           | 必须        | 说明        |
| --------- | --------------- | -------   | --------- |
|name | string | 是 |  文件名（需包含文件扩展名，如“文件.doc” |
|type |string | 是 | 文件类型（image 或 attachment）  |
|content | file | 是 |文件 |
**注意**：每次只能上传一个文件，如有多个文件，请分多次上传。文件类型（image 或 attachment）取决于审批定义表单控件中的具体类型，请按定义使用。

### 请求体示例

```json
{
	"name":"123.doc",
	"type":"attachment",
	"content":123.doc
}
````

## 响应

### 响应体

| 参数         |类型         |必须  | 说明        |
| --------- | ----------|----- | --------- |
|code |int |是 |错误码，非0表示失败 |
|msg | string |是| 返回码的描述|
|data | map |是| 返回业务信息 |
|&emsp;∟code|string|是| 文件标识码（用于创建审批实例）|
|&emsp;∟url|string|是| 文件 url|
**注意**：返回的 url 有效期为12小时，发起审批后, 每次获取详情都会获得新的 url。
### 响应体示例

```json
{
    "code":0,
    "msg":"success",
    "data": {
        "code": "D93653C3-2609-4EE0-8041-61DC1D84F0B5",
        "url": "https://p3-approval-sign.byteimg.com/lark-approval-attachment/image/20210819/a8c1a1f1-47ae-4147-9deb-a8bf2cd833b1.jpg~tplv-ottatrvjsm-image.image?x-expires=1634941752&x-signature=oaZ6Tfv50ryUesNwKTUTnBlJivY%3D#.jpg"
    }
}
```