上传资源
更新时间 2025-07-31 13:42:04
接口说明
该接口用于小程序上传资源。
在调用需要上传资源的接口前,都需要先使用这个上传接口拿到资源地址。
基本信息
| 名称 | 描述 |
|---|---|
| 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
上传的资源类型,支持的类型及限制见 "支持的资源类型" 章节
请求示例
Java
import com.aliyun.tea.TeaException; import com.douyin.openapi.client.Client; import com.douyin.openapi.client.models.V2FileUploadMaterialRequest; import com.douyin.openapi.client.models.V2FileUploadMaterialResponse; import com.douyin.openapi.credential.models.Config; import com.douyin.openapi.util.models.FileField; import java.io.FileInputStream; public class Main { public static void main(String[] args) { try { Config config = new Config().setClientKey("tt******").setClientSecret("*******"); Client client = new Client(config); /* 构建请求参数,该代码示例中只给出部分参数,请用户根据需要自行构建参数值 token: 1.若用户自行维护token,将用户维护的token赋值给该参数即可 2.SDK包中有获取token的函数,请根据接口path在《OpenAPI SDK 总览》文档中查找获取token函数的名字 在使用过程中,请注意token互刷问题 header: sdk中默认填充content-type请求头,若不需要填充除content-type之外的请求头,删除该参数即可 */ V2FileUploadMaterialRequest sdkRequest = new V2FileUploadMaterialRequest(); sdkRequest.setAccessToken("k23cd*****"); sdkRequest.setMaterialType(1); FileInputStream fis = new FileInputStream("./test.png"); // 改成自己的文件地址 FileField uploadFile = new FileField(); uploadFile.filename = "test.png"; // 改成自己的名字 uploadFile.contentType = "image/png";// 改成上传文件的MINE type uploadFile.content = fis; sdkRequest.setMaterialFile(uploadFile); V2FileUploadMaterialResponse sdkResponse = client.V2FileUploadMaterial(sdkRequest); } catch (TeaException e) { System.out.println(e.getMessage()); } catch (Exception e) { System.out.println(e.getMessage()); } } }
响应参数
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 | |
