# 文件上传

## 背景介绍

检测流程中，在检测项目列表中，选择某个检测项目，就进入到具体的检测流程。此检测流程会首先罗列所有需要操作的检测模块。点击某个检测模块，比如“机舱初检”，就会打开对应的检测项列表，如下图所示：

![](https://1566961082-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MX4yiRKQOsNsAm8ojEM%2F-Mg9p6NioMhUS-zClVYv%2F-MgA0sCxJu3g58ne5He_%2Fimage.png?alt=media\&token=8c02f38f-e0cb-4e34-ad35-bda0180d4c19)

在检测项列表页面，可以提交图片和视频资源。这些视频资源，先保存到开发者所在第三方公司的文件服务器上，然后将文件URL同步给开放平台。

## 请求地址

| 环境     | HTTPS请求地址                                            |
| ------ | ---------------------------------------------------- |
| 国内沙盒环境 | https://cnopenapi.autox3.com/openapi/api-v1/rest     |
| 国内生产环境 | https://cnopengateway.autox3.com/openapi/api-v1/rest |
| 其他国家环境 | 略                                                    |

## 请求参数

| 名称      | 子项                | 是否必填 | 长度 | 类型     | 说明                                                                | 示例值                                                                                                                                                                                 |
| ------- | ----------------- | ---- | -- | ------ | ----------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| method  |                   | 是    | 64 | String | 方法名                                                               | <p>autox3.system.</p><p>fileupload</p>                                                                                                                                              |
| content |                   | 是    | -- | String | 请求接口内容字符串JSON                                                     |                                                                                                                                                                                     |
|         | inspectionOrderId | 是    | 64 | String | 开放平台检测单Id                                                         | 3348                                                                                                                                                                                |
|         | fileUrl           | 是    | 64 | String | 文件URL                                                             | <p><a href="https://i18n.autox3.com/1.jpeg">https://i18n.autox3.</a></p><p><a href="https://i18n.autox3.com/1.jpeg">com</a><a href="https://i18n.autox3.com/1.jpeg">/1.jpeg</a></p> |
|         | fileType          | 是    | 64 | String | <p>文件类型，</p><p>图片:image/*，</p><p>音频:audio/*，</p><p>视频:video/*</p> | image/\*                                                                                                                                                                            |
|         | fileSize          | 是    | 64 | String | 文件大小，单位:字节                                                        | 10240                                                                                                                                                                               |
|         | createTime        | 是    | 64 | String | 创建时间                                                              | 2021-08-05 09:00:00                                                                                                                                                                 |
|         | platform          | 是    | 64 | String | 拍照设备信息                                                            | iphoneX                                                                                                                                                                             |
|         | height            | 否    | 64 | String | 图片高度，单位:像素                                                        | 800                                                                                                                                                                                 |
|         | width             | 否    | 64 | String | 图片宽度，单位:像素                                                        | 600                                                                                                                                                                                 |

请求命令(以curl命令为例)示例如下：

{% tabs %}
{% tab title="curl" %}
```
curl 'https://cnopenapi.autox3.com/openapi/api-v1/rest' \
-H "accept: */*"  \
-H "Authorization: ${token}" \
-H 'Content-Type: application/json;charset=UTF-8' \
--data-raw ' \
{ \
    "method": "autox3.system.fileupload",\
    "content": "{\"inspectionOrderId\":\"7867\",\"url\":\"http://cn-service-pic.autox3.com/201124144945mixmsbQhIp.png\",\"fileType\":\"image/*\",\"fileSize\":\"10240\",\"createTime\":\"2021-08-0509:00:00\",\"platform\":\"iphoneX\",\"height\":\"800\",\"width\":\"600\"}" \
} \
' \
--compressed               
```
{% endtab %}
{% endtabs %}

## 应答参数



| 名称        | 子项 | 是否必填 | 长度 | 类型      | 说明                   | 示例值           |
| --------- | -- | ---- | -- | ------- | -------------------- | ------------- |
| status    |    | 是    | -- | Integer | 请参考本页"公共参数-->错误编码"部分 | 0             |
| errorInfo |    | 是    | -- | String  | 错误信息                 | network error |
| data      |    | 是    | -- | Object  | 请参考“文件对象信息封装”        |               |



文件对象信息封装，请参考如下：

| 名称     | 是否必填 | 长度 | 类型     | 说明        | 示例值   |
| ------ | ---- | -- | ------ | --------- | ----- |
| fileId | 是    | -- | String | 开放平台的文件Id | 23138 |

注： 其他冗余字段可以忽略

**应答示例如下：**

```
{
	"data":{
      "fileId":"23138"                 
	},
	"errorInfo":null,
	"status":0
}  
```











