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

    收藏
    我的收藏

    接口说明

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

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

    基本信息

    名称描述
    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 状态码错误码错误码描述排查建议
    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