第三方小程序应用上传资源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
dataStruct
展开子属性
响应示例
正常响应示例异常响应示例
{ "data": { "path": "xxxxx" }, "err_msg": "", "err_no": 0, "log_id": "202401151619351CF77AE5F7A43B8393C0" }
错误码
| HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
|---|---|---|---|
| 200 | 40001 | 参数错误 | |
| 200 | 40031 | 上传的材料大小超过限制 | |
| 200 | 40032 | 上传的材料格式无效 |
支持的资源类型
material_type | 文件说明 | 用途 | 文件大小限制 | 文件格式要求 | 建议 |
1 | 营业执照 | 提交入驻质材料接口 | 小于等于 4MB | jpeg、jpg、png | |
2 | 小程序图标 | 代创建小程序 | 小于等于2MB | jpeg、jpg、png | 像素为 200 * 200 |
