上传临时素材接口
收藏我的收藏
使用限制
目前支持的素材如下:
类型 | 大小 | 格式 | 其他说明 |
图片 | 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 | ba253642-0590-40bc-9bdf-9a1334b94059 | 是 | |
access_token | string | 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 | 修改参数取值 |