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

更新时间 2024-09-09 06:47:18

我的收藏

该接口用于第三方小程序应用上传资源。在第三方小程序应用调用需要上传资源的接口前，都需要先使用这个上传接口拿到资源地址。

基本信息

基本信息
HTTP URL	https://open.microapp.bytedance.com/openapi/v1/tp/upload_pic_material
HTTP Method	POST

请求头

名称	类型	必填	描述
content-type	string	是	示例值："multipart/form-data; boundary=---7MA4YWxkTrZu0gW"

请求参数

Query

名称	类型	是否必填	描述	示例值
component_appid	string	是	第三方小程序应用 appid	ttd429**********91
component_access_token	string	是	第三方小程序应用接口调用凭据	628f1******e93b9

Body（form-data）

名称	类型	是否必填	描述	示例值
material_type	int32	是	上传的文件类型	1
material_file	file	是	资源内容，字节流

material_type 的取值：

material_type	文件说明	用途	文件大小限制	文件格式要求	建议
1	营业执照	提交入驻质材料接口	小于等于 4MB	jpeg、jpg、png
2	小程序图标	代创建小程序	小于等于2MB	jpeg、jpg、png	像素为 200 * 200

请求示例

HTTP复制
curl --location 'https://open.microapp.bytedance.com/openapi/v1/tp/upload_pic_material?component_access_token=xxxxxxxxxxx' \
--form 'material_type="1"' \
--form 'material_file=@"/xxxx/xxx.jpeg"'

响应参数

名称	类型	是否必填	描述	示例值
errno	int	是	错误码	0
message	string	是	错误信息	success
log_id	string	是	标识请求的唯一id	202008121419360101980821035705926A
data	object	否	响应数据，成功才返回

data 说明：

名称	类型	是否必填	描述	示例值
path	string	是	资源路径	tos-boe-i-giy*8/ddc***1c6

响应示例

正常示例

json复制
{
  "errno": 0,
  "message": "success",
  "log_id": "202008121419360101980821035705926A",
  "data": {
    "path": "tos-boe-i-giy***8/ddc*****1c6"
  }
}

异常示例

json复制
{
  "errno": 40001,
  "message": "参数错误",
  "log_id": "202008121419360101980821035705926A"
}

错误码

HTTP 状态码	错误码	描述	排查建议
200	40001	参数错误	查看传参是否正确
200	40003	找不到相关第三方小程序应用	确定 component_appid 是否正确
200	40009	第三方小程序应用 component_access_token 已过期	确定 component_access_token 是否过期
200	40010	第三方小程序应用 component_access_token 不正确	确定 component_access_token 是否正确
200	40031	上传的材料大小超过限制
200	40032	上传的材料格式无效