更新时间:2025-07-22 GMT+08:00
分享

上传图片

功能介绍

上传图片入库。

URI

POST /v1/{project_id}/applications/{application_id}/uni-search/img/{img_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

项目ID,获取方法请参见获取项目ID

约束限制:

不涉及

取值范围:

1~64个字符,只能包含数字、字母、中划线和下划线,且必须以字母开头。

默认取值:

不涉及

application_id

String

参数解释:

应用ID,获取方法请参见获取应用ID

约束限制:

字符串

取值范围:

1~64个字符,只能包含数字、字母、中划线和下划线,且必须以字母开头。

默认取值:

不涉及

img_id

String

参数解释:

图片的id。

约束限制:

必须为32位的字母或数字,且以"img-"开头。

取值范围:

不涉及

默认取值:

不涉及

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

接口鉴权使用的Token,Token获取方式参考:获取IAM用户Token

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

表3 FormData参数

参数

是否必选

参数类型

描述

image

File

参数解释:

上传的图片文件。

约束限制:

必须为png、jpg或jpeg格式,且大小不能超过20MB。

取值范围:

不涉及

默认取值:

不涉及

响应参数

状态码:200

上传成功。

状态码:400

表4 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码

取值范围:

不涉及

error_msg

String

参数解释:

错误描述。

取值范围:

不涉及

状态码:500

表5 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码

取值范围:

不涉及

error_msg

String

参数解释:

错误描述。

取值范围:

不涉及

请求示例

响应示例

状态码

状态码

描述

200

上传成功。

400

请求错误。

500

内部异常。

错误码

请参见错误码

相关文档