抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • OpenAPI 列表
  • 通用参数
  • 移动/网站应用 OpenAPI SDK 总览
  • 状态码排查工具
  • 个人资料
  • 关系能力
  • 内容能力
  • 搜索能力
  • 私信群聊
  • 生活服务开放能力
  • 工具能力
  • 素材管理
  • 上传素材接口
  • 上传临时素材接口
  • 素材列表接口
  • 删除素材接口
  • 小程序接口能力
  • 沙盒管理
  • ticket 管理
  • 服务市场开放能力
  • 小程序推广计划
  • 联合授权
  • 上传临时素材接口
    收藏
    我的收藏

    使用限制

    目前支持的素材如下:
    类型
    大小
    格式
    其他说明
    图片
    5MB
    bmp/gif/png/jpeg/jpg
    长度<1500
    宽度<1500
    PDF
    10MB
    pdf

    接口说明

    用于上传临时素材。

    基本信息

    名称
    描述
    HTTP URL
    https://open.douyin.com/enterprise/media/temp/upload/
    HTTP Method
    POST
    Scope
    enterprise.im
    权限要求
    当前暂不支持新增申请

    请求头

    参数名称
    类型
    参数描述
    参数示例
    是否必填
    Content-Type
    string
    固定值:multipart/form-data
    multipart/form-data

    请求参数

    Query

    参数名称
    参数类型
    参数描述
    参数示例
    是否必填
    open_id
    string
    用户唯一标志。通过调用 https://open.douyin.com/oauth/access_token/ 生成的 open_id 字段获取
    ba253642-0590-40bc-9bdf-9a1334b94059
    access_token
    string
    接口调用凭证。通过调用 https://open.douyin.com/oauth/access_token/生成的 access_token 字段获取
    act.1d1021d2aee3d41fee2d2add43456badMFZnrhFhfWotu3Ecuiuka27L56lr

    Body

    参数名称
    参数类型
    参数描述
    参数示例
    是否必填
    media
    byte[]
    素材文件。若素材为图片,则长宽不能大于 1500,大小建议不超过 5MB。
    <nil>

    请求示例

    curl -X POST "https://open.douyin.com/enterprise/media/temp/upload/?open_id=ba253642-0590-40bc-9bdf-9af334b94059&access_token=act.1d1021d2aee3d41fee2d2add43456badMFZnrhFhfWotu3Eoi" \ -H "Content-Type: multipart/form-data" \ -F "media=@/path/to/your/file.jpg"

    响应参数

    参数名称
    参数类型
    参数描述
    参数示例
    是否必填
    extra
    struct
    <nil>
    - sub_description
    string
    子错误码描述
    - sub_error_code
    int64
    子错误码
    0
    false
    - description
    string
    错误码描述
    false
    - error_code
    int64
    错误码
    0
    false
    - logid
    string
    标识请求的唯一 id
    202008121419360101980821035705926A
    false
    - now
    int64
    毫秒级时间戳
    1597213176393
    false
    data
    struct
    <nil>
    - description
    string
    错误码描述
    false
    - error_code
    int64
    错误码
    0
    false
    - media
    struct
    <nil>
    false
    -- media_id
    string
    <nil>
    false
    -- url_list
    string[]
    <nil>
    false

    响应示例

    正常示例

    { "data": { "description": "", "error_code": "0", "media": { "media_id": "<nil>", "url_list": ["<nil>"] } }, "extra": { "description": "", "error_code": "0", "logid": "202008121419360101980821035705926A", "now": "1597213176393", "sub_description": "", "sub_error_code": "0" } }

    异常示例

    { "data": { "description": "Parameter error", "error_code": 2100005 }, "extra": { "logid": "2020070614111601022506808001045D59", "now": 1594015876138 } }

    错误码

    HTTP 状态码
    错误码
    错误码描述
    排查建议
    200
    2100005
    Parameter error
    修改参数取值