上传临时素材接口
收藏
我的收藏

使用限制

目前支持的素材如下：

类型	大小	格式	其他说明
图片	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	修改参数取值

上传临时素材接口收藏我的收藏

使用限制

接口说明

基本信息

请求头

请求参数

Query

Body

请求示例

响应参数

响应示例

正常示例

异常示例

错误码

上传临时素材接口
收藏
我的收藏