图片上传

我的收藏

使用限制

无

接口说明

发起进件请求需要上传商户证件等图片，需要先调用图片上传接口获取 image_id。

基本信息

基本信息
HTTP URL	https://open.douyin.com/api/apps/ecpay/v3/saas/image_upload/
HTTP Method	POST
Scope	trade_basic.developer.create_merchant
权限要求	不需要用户授权

请求头

名称	类型	必填	描述
Content-Type	string	是	固定值 "multipart/form-data"
access-token	string	是	请求token，根据是否为服务商调用不同接口 •服务商身份获取token链接 •非服务商身份获取token链接

请求参数

名称	类型	是否必填	最大长度	描述	示例值
image_type	string	是	64	图片格式，支持格式：jpg、jpeg、png	jpg
image_content	byte_array	是	2097152	图片二进制字节流，最大为2M

请求示例

curl --location --request POST 'https://open.douyin.com/api/apps/ecpay/v3/saas/image_upload/' \
--header 'access-token: clt.test_token' \
--header 'Cookie: passport_csrf_token=7df22e40a254d7459779860f3797f2ee; passport_csrf_token_default=7df22e40a254d7459779860f3797f2ee' \
--form 'image_type="png"' \
--form 'image_content=@"/Users/File/Downloads/1280X1280.PNG"'

响应参数

公共响应参数

名称	类型	是否必填	描述	示例值
err_no	int64	是	状态码 0 代表业务处理成功，具体错误码参见后文错误码章节	0
err_msg	string	是	错误提示信息	success
log_id	string	是	抖音开平统一日志id
data	object	否	返回数据信息

业务响应参数 data

名称	类型	是否必填	最大长度	描述	示例值
image_id	string	是	256	图片在文件存储平台的标识	img-id-123

响应示例

正常示例

{
    "err_msg": "",
    "err_no": 0,
    "log_id": "2023092816095296C280CE8A44F0D0CCF9",
    "data": {
        "image_id": "img-id-123"
    }
}

异常示例

{
    "err_no": 28001008,
    "err_msg": "access_token过期,请刷新或重新授权",
    "log_id": "202310061616226C30B180133AE61392D7"
}

错误码

HTTP 状态码	错误码	描述	排查建议
200	0	""	上传成功
200	7004	超过单个图片允许的限制(2M)	请适当压缩图片大小以免超过上传限制
200	7005	图片文件为空	商户更换文件后，重新调用
200	7006	未知图片类型	图片类型必须为JPG, PNG，JPEG
200	28001008	access_token过期,请刷新或重新授权	access_token过期,请根据请求头中token获取方式调用接口重新获取