- 小程序 OpenAPI SDK 总览
- OpenAPI 简介
- 用户登录态签名
- 签名算法
- 联合授权
- 接口调用凭证
- 登录
- 小程序码与小程序链接
- Web 化接入
- 私信和群聊
- 解决方案
- 线索组件
- 隐私协议
- 视频能力
- 搜索能力
- 任务能力
- 电商
- 生活服务
- 短剧行业
- 用户信息
- 分享
- 客服
- 交易工具
- 小程序券
- 交易系统
- 素材库
- 内容安全
- 泛知识
- 担保支付
- 评价
- 其它
- 订阅消息
- 小程序推广计划
- 挂载
- 分发
- 数据分析
- 服务类目
- 直播间能力
- 抖音开放能力
- 能力申请
- 页面结构自定义
- 普通二维码绑定
- 抖音号绑定
- 流量主
- 抖店绑定
图片上传
更新时间 2024-07-24 02:58:49
收藏
我的收藏使用限制
无
接口说明
发起进件请求需要上传商户证件等图片,需要先调用图片上传接口获取 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 | |
请求示例
SQL复制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 |
响应示例
正常示例
SQL复制{
"err_msg": "",
"err_no": 0,
"log_id": "2023092816095296C280CE8A44F0D0CCF9",
"data": {
"image_id": "img-id-123"
}
}
异常示例
SQL复制{
"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获取方式调用接口重新获取 |
点击纠错