抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • OpenAPI 简介
  • 通用参数
  • 小程序 OpenAPI SDK 总览
  • 签名算法
  • 基础能力
  • 触达与营销
  • 支付
  • 运营
  • 生活服务
  • 垂直行业
  • 其它
  • 上传资源
  • 上传资源

    更新时间 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

    上传的资源类型,支持的类型及限制见 "支持的资源类型" 章节

    请求示例
    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 状态码错误码错误码描述排查建议
    20040031
    上传的材料大小超过限制
    20040032
    上传的材料格式无效
    20028001005
    系统内部错误,请重试
    请求重试,若依然无解请向平台提交反馈
    20028001003
    access_token无效
    重新请求生成access_token
    20028001008
    access_token过期,请刷新或重新授权
    重新请求生成access_token
    20028001006
    网络调用错误,请重试
    重试即可

    支持的资源类型

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