图片上传
收藏使用限制
无
接口说明
发起进件请求需要上传商户证件等图片，需要先调用图片上传接口获取 image_id。
基本信息
基本信息 | |
HTTP URL | |
HTTP Method | POST |
Scope | trade_basic.developer.create_merchant |
权限要求 | 不需要用户授权 |
请求头
名称 | 类型 | 必填 | 描述 |
Content-Type | string | 是 | 固定值 "multipart/form-data" |
access-token | string | 是 | 请求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获取方式调用接口重新获取 |
