接口说明

该接口用于小程序上传资源。

在调用需要上传资源的接口前，都需要先使用这个上传接口拿到资源地址。

基本信息

名称	描述
HTTP URL	https://open.douyin.com/api/apps/v2/file/upload_material/
HTTP Method	POST
Scope	ma.upload
权限要求	服务商代调用场景下，需商家授予基本信息设置权限集

请求参数

请求头

access-token必填String

示例：clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ

调用https://open.douyin.com/oauth/client_token/生成的token

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	文件说明	用途	文件大小限制	文件格式要求	建议
5	场景示例图	用于申请小程序能力	小于等于 5MB	jpeg、jpg、png
10	合同照片	用于绑定抖音号	小于等于5MB	jpeg、jpg、png
11	系统截图	用于配置抖店应用	小于等于 5MB	jpeg、jpg、png、bmp、gif

上传资源在线调试

接口说明

基本信息

请求参数

响应参数

错误码

支持的资源类型

上传资源