开发
API
自2022年9月6日起,本文档站不再更新内容,相关文档已迁移至全新“抖音开放平台”前往

图片上传接口

接口功能描述:发起进件请求需要上传商户证件等图片,需要先调用图片上传接口获取 image_id。

注意事项

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

接口地址

请求URL

https://developer.toutiao.com/api/apps/ecpay/saas/image_upload

请求方式

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


请求示例

{
  "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

响应示例

正常响应示例

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

异常异常示例

{
  "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

点击纠错
该文档是否对你的开发有所帮助?
有帮助
没帮助
该文档是否对你的开发有所帮助?
有帮助
没帮助