上传资源
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
https://developer.toutiao.com/api/apps/v1/capacity/upload_material
在调用需要上传资源的接口前，都需要先使用这个上传接口拿到资源地址。
权限要求
服务商代调用场景下，需商家授予运营管理权限集
material_type 的取值：
| material_type | 文件说明 | 用途 | 文件大小限制 | 文件格式要求 |
|---|---|---|---|---|
| 1 | 场景示例图 | 用于申请小程序能力 | 小于等于 2MB | jpeg、jpg、png、bmp、gif |
| 2 | 合同照片 | 用于绑定抖音号 | 小于等于5MB | jpeg、jpg、png |
| 3 | 系统截图 | 用于配置抖店应用 | 小于等于 5MB | jpeg、jpg、png、bmp、gif |
错误码
| 错误码 | 描述 | 排查建议 |
|---|---|---|
| -1 | 系统错误 | 建议重试 |
| 11001 | appid无法解析 | 建议重试 |
| 11009 | 参数不合法或缺少参数 | 检查参数合法性 |
| 11016 | access_token不正确或者已过期 | 检查access_token合法性 |
| 40006 | 非法请求，请求 IP 不在第三方小程序应用 IP 地址白名单内 | 添加IP地址到白名单内或者配置白名单为空 |
| 40036 | 授权小程序未授予该接口对应的权限 | 引导商家授予相关权限集 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://developer.toutiao.com/api/apps/v1/capacity/upload_material' \
--header 'access-token;' \
--header 'content-type: application/json' \
--data-raw '{
"err_msg": "success",
"err_no": 0,
"data": {
"path": "xxxxx"
}
}'响应示例响应示例
{
"err_no": 0,
"err_msg": "string"
}请求参数
Header 参数
content-type
string
必需
access-token
string
必需
Body 参数application/json