抖音开放平台Logo
控制台

图片上传接口
收藏
我的收藏

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

​使用限制​

无​

​接口说明​

    1.​请求参数必须使用 form 表单格式。​

​基本信息​

基本信息​
HTTP URL​
https://developer.toutiao.com/api/apps/ecpay/saas/image_upload
HTTP Method​
POST​
接口频次​
20QPS(小程序app_id维度或者thirdparty_id纬度)​

​请求头​

名称​
类型​
必填​
描述​
Content-Type​
string​
是​
固定值 "multipart/form-data"​

​请求参数​

名称​
类型​
是否必填​
最大长度​
描述​
示例值​
app_id​
string​
条件选填​
64​
小程序的 app_id​
在开发者身份下必填​
ttdb96ad2b44aeff3301​
access_token​
string​
条件选填​
64​
小程序token​
在开发者身份下必填​
获取链接​
567234784​
thirdparty_id​
string​
条件选填​
64​
小程序第三方平台应用 id​
在服务商身份下必填​
ttc4a8b2155b82682f​
component_access_token​
string​
条件选填​
64​
服务商绑定的token​
在服务商身份下必填​
获取链接​
"8431201934ab"​
image_type​
string​
是​
64​
图片格式，支持格式：jpg、jpeg、png​
jpg​
image_content​
byte_array​
是​
2097152​
图片二进制字节流，最大为2M​
​

​请求示例​

key​
value​
app_id​
ttdb96ad2b44aeff3301​
access_token​
567234784​
image_type​
jpg​
image_content​
010101​

​响应参数​

​公共响应参数​

名称​
类型​
是否必填​
最大长度​
描述​
示例值​
error_no​
number​
是​
-​
返回码，详见错误码及错误描述​
2008​
error_tips​
string​
是​
-​
返回码描述，详见错误码及错误描述​
签名校验异常，请使用正确的签名和 json 传参​

​业务响应参数​

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

​响应示例​

​正常响应示例​

json
复制
{
"err_no": 0,
"err_tips": "",
"image_id": "6523.jpeg"
}

​异常异常示例​

json
复制
{
"err_no": 2008,
"err_tips": "签名校验异常，请使用正确的签名和 json 传参",
"image_id": ""
}

​错误码​

错误码​
err_no​
描述​
err_tips​
排查建议​
0​
""​
上传成功​
2008​
签名校验异常，请使用正确的签名和 json 传参​
请检查app_id和access_token或者thirdparty_id和component_access_token的正确性​
7004​
超过单个图片允许的限制(2M)​
请适当压缩图片大小以免超过上传限制​
7005​
图片文件为空​
商户更换文件后，重新调用​
7006​
未知图片类型​
图片类型必须为JPG, PNG，JPEG​
​