图片上传

开发环境

http://dev-cn.your-api-server.com

POST

/api/apps/ecpay/v3/saas/image_upload/

接入前，请先查看接入前准备是否完成
发起进件请求需要上传商户证件等图片，需要先调用图片上传接口获取 image_id。

错误码

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

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'http://dev-cn.your-api-server.com/api/apps/ecpay/v3/saas/image_upload/' \
--header 'access-token: clt.test_token' \
--form 'image_type="png"' \
--form 'image_content="/Users/File/Downloads/1280X1280.PNG"' \
--form 'image=""'

响应示例

200 - 成功示例

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

请求参数

Header 参数

access-token

string

必需

示例值:

clt.test_token

Body 参数multipart/form-data

image_type

string

必需

示例值:

png

image_content

string

必需

示例值:

/Users/File/Downloads/1280X1280.PNG

image

string

必需

图片二进制字节流，最大为2M

返回响应

🟢200成功

application/json

Body

err_msg

string

错误提示信息

必需

err_no

integer

必需

状态码 0 代表业务处理成功，具体错误码参见后文错误码章节

log_id

string

必需

抖音开平统一日志id

data

object

返回数据信息

可选

image_id

string

必需

🟠400请求有误

通用参数

发起进件

图片上传

错误码#

请求参数

返回响应

错误码