代授权小程序上传资源V2
收藏接口说明
该接口用于小程序上传资源。
在调用需要上传资源的接口前，都需要先使用这个上传接口拿到资源地址。
基本信息
| 名称 | 描 述 |
|---|---|
| HTTP URL | https://open.douyin.com/api/apps/v2/file/upload_material/ |
| HTTP Method | POST |
| Scope | ma.upload |
| 权限要求 | 服务商代调用场景下，需商家授予基本信息设置权限集 |
请求参数
请求头
access-token必填String
示例：clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
Content-Type必填String
示例：multipart/form-data
固定值"multipart/form-data"
Body
material_file必填Binary
资源内容，字节流
material_type必填Int32
示例：1
上传的资源类型，支持的类型及限制见 "支持的资源类型" 章节
请求示例
curl --location 'https://open.douyin.com/api/apps/v2/file/upload_material/' \ --header 'access-token: isvact.15exxxxxxeOhu3UEynUKzvi0b2Kugshu83cqR7' \ --form 'material_type="1"' \ --form 'material_file=@"/xxx/xxx"'
响应参数
Body展开全部子属性
err_msg必填String
错误描述
err_no必填Int32
示例：0
错误码
log_id必填String
示例：20240117111703C894A05202C8065DC87D
标识请求的唯一id
dataStruct
展开子属性
响应示例
正常响应示例异常响应示例
{ "data": { "path": "xxxxx" }, "err_msg": "", "err_no": 0, "log_id": "20240117111703C894A05202C8065DC87D" }
切换单列布局错误码
| HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
|---|---|---|---|
| 200 | 40031 | 上传的材料大小超过限制 | |
| 200 | 40032 | 上传的材料格式无效 | |
| 200 | 28001005 | 系统内部错误，请重试 | 请求重试，若依然无解请向平台提交反馈 |
| 200 | 28001003 | access_token无效 | 重新请求生成access_token |
| 200 | 28001008 | access_token过期,请刷新或重新授权 | 重新请求生成access_token |
| 200 | 28001006 | 网络调用错误，请重试 | 重试即可 |
支持的资源类型
material_type | 文件说明 | 用途 | 文件大小限制 | 文件格式要求 | 建议 |
1 | 小程序图标 | 修改小程序图标接口 | 小于等于 2MB | jpeg、jpg、png | 像素为 200 * 200 |
2 | 小程序服务类目资质材料 | 增加服务类目接口 补充服务类目资质信息接口 | 小于等于 2MB | jpeg、jpg、png | |
3 | 小程序名称审核材料 | 修改小程序名称接口 | 小于等于 2MB | jpeg、jpg、png | |
4 | 小程序落地页截图 | 用于申请小程序能力 | 小于等于 2MB | jpeg、jpg、png | |
5 | 场景示例图 | 用于申请小程序能力 | 小于等于 5MB | jpeg、jpg、png | |
6 | 小程序分享模板图片 | 新增分享模板接口 修改分享模板接口 | 小于等于 1MB | jpeg、jpg、png | 像素为 500 * 400 |
7 | 商铺营业执照、行业资质材料 | 提交商铺资质材料接口 | 小于等于 4MB | jpeg、jpg、png | |
8 | 服务商和商家的合作协议 | 提交商铺资质材料接口 | 小于等于 4MB | pdf | |
10 | 合同照片 | 用于绑定抖音号 | 小于等于5MB | jpeg、jpg、png | |
11 | 系统截图 | 用于配置抖店应用 | 小于等于 5MB | jpeg、jpg、png、bmp、gif | |
12 | 小程序服务类目视频类资质材料 | 增加服务类目接口 补 充服务类目资质信息接口 | 小于等于30MB | video/mp4、video/webm | |
