- 调用格式说明
- Postman模板使用说明
- 第三方小程序应用密钥使用说明
- 第三方小程序应用上传资源
- 第三方小程序应用上传资源V2
- 授权
- 域名
- 模板管理
- 代商家管理小程序
- 代商家入驻抖音开放平台
第三方小程序应用上传资源V2
收藏
我的收藏接口说明
该接口用于第三方小程序应用上传资源。在第三方小程序应用调用需要上传资源的接口前,都需要先使用这个上传接口拿到资源地址。
基本信息
名称 | 描述 |
---|---|
HTTP URL | https://open.douyin.com/api/tpapp/v2/file/upload_material/ |
HTTP Method | POST |
Scope | thirdparty.dev.upload |
请求头
名称 | 字段类型 | 是否必填 | 示例 | 描述 |
---|---|---|---|---|
access-token | String | 是 | clt.05efxxxxxxxxxqPf9pWBo0IKVHmSKce5EvKX | |
Content-Type | String | 是 | multipart/form-data |
请求参数
Body
名称 | 字段类型 | 是否必填 | 示例 | 描述 |
---|---|---|---|---|
material_file | Binary | 是 | 资源内容,字节流 | |
material_type | Int32 | 是 | 1 | 上传的资源类型,支持的类型及限制见 "支持的资源类型" 章节 |
请求示例
curl --location 'https://open.douyin.com/api/tpapp/v2/file/upload_material' \
--header 'access-token: clt.05efb2xxxxxxxxxxxqPf9pWBo0IKVHmSKce5EvKX' \
--form 'material_type="1"' \
--form 'material_file =@"xxxx"'
响应参数
Body
名称 | 字段类型 | 是否必填 | 示例 | 描述 |
---|---|---|---|---|
err_msg | String | 是 | 错误描述 | |
err_no | Int32 | 是 | 0 | 错误码 |
log_id | String | 是 | 202401151619351CF77AE5F7A43B8393C0 | 标识请求的唯一id |
data | Struct | 否 |
响应示例
正常响应示例
{
"data": {
"path": "xxxxx"
},
"err_msg": "",
"err_no": 0,
"log_id": "202401151619351CF77AE5F7A43B8393C0"
}
异常响应示例
{
"err_no": 40032,
"log_id": "20240115162037903F733F9651B2619A49",
"err_msg": "上传的材料格式无效"
}
错误码
http状态码 | 错误码 | 错误码描述 | 排查建议 |
---|---|---|---|
200 | 40001 | 参数错误 | |
200 | 40031 | 上传的材料大小超过限制 | |
200 | 40032 | 上传的材料格式无效 |
支持的资源类型
material_type | 文件说明 | 用途 | 文件大小限制 | 文件格式要求 | 建议 |
1 | 营业执照 | 提交入驻质材料接口 | 小于等于 4MB | jpeg、jpg、png | |
2 | 小程序图标 | 代创建小程序 | 小于等于2MB | jpeg、jpg、png | 像素为 200 * 200 |
点击纠错