第三方小程序应用上传资源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	调用https://open.douyin.com/openapi/v2/auth/tp/token/生成的token
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

第三方小程序应用上传资源V2在线调试

接口说明

基本信息

请求头

请求参数

Body

请求示例

响应参数

Body

响应示例

正常响应示例

异常响应示例

错误码

​支持的资源类型​

第三方小程序应用上传资源V2

支持的资源类型