【泛知识】上传课程资源
开发环境
开发环境
POST
/product/api/upload_resource
API 说明
该接口用于上传课程资源，在调用课程上传接口前，需要先使用这个课程资源上传接口拿到返回的资源 uri。
特别注意，资源为异步上传，请接入回调通知获取资源上传状态，避免资源未上传完成直接上传课程
使用限制
因为课程资源文件往往比较大，平台提供的带宽相对比较有限，如果需要大批量上传课程资源，请保证上传 QPS 不大于 50。
需要注意，泛知识下所有接口均需要满足小程序类目为 教育类-教育-在线教育 才可以调用
接口说明
上传资源后会立即得到一个 uri，但实际上资源上传为异步过程，如果上传资源后立即上传课程资源，可能会导致找不到该 uri 而导致该课程上传失败。需要获取所有资源上传回调通知成功的状态后，或者通过查询课程资源上传状态接口确认所有 uri 都上传成功后，再上传课程/资质，资源上传详细流程:
基本信息
| HTTP URL | 正式环境：https://developer-product.zijieapi.com/product/api/upload_resource 沙盒环境：https://open-sandbox.douyin.com/product/api/upload_resource |
|---|---|
| HTTP Method | POST |
| 权限要求 | AccessToken鉴权 |
枚举参数
resource_type--资源类型
课程相关
| 资源类型 | 资源类型编码 | 文件限制大小 |
|---|---|---|
| 商品详情图片 | 1 | <= 50MB |
| 商品视频履约内容 | 2 | <= 5GB |
| 商品音频履约内容 | 3 | <= 5GB |
| 商品图片履约内容 | 4 | <= 50MB |
| 商品pdf履约内容 | 5 | <= 5GB |
| 商品office履约内容 | 6 | <= 5GB |
资质相关
| 资源类型 | 资源类型编码 | 文件限制大小 | 文件格式要求 |
|---|---|---|---|
| 老师身份证照片 | 21 | <= 50MB | jpeg、jpg、png |
| 机构法人身份证照片 | 22 | <= 50MB | jpeg、jpg、png |
| 老师资质照片 | 23 | <= 50MB | jpeg、jpg、png |
| 机构资质照片 | 24 | <= 50MB | jpeg、jpg、png |
| 机构logo照片 | 25 | <= 50MB | jpeg、jpg、png |
交易展示相关
| 资源类型 | 资源类型编码 | 文件限制大小 | 文件格式要求 |
|---|---|---|---|
| 课程展示图片 | 31 | <= 5MB | jpeg、jpg、png |
| 老师展示图片 | 32 | <= 5MB | jpeg、jpg、png |
| 机构展示图片 | 33 | <= 5MB | jpeg、jpg、png |
请求参数
Body 参数application/json
返回响应
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/product/api/upload_resource' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"access_token": "0801121846735561486f5a48744d744157456a554a68446d52773d3d",
"appid": "tt77fd0140e89bba8401",
"resource_type": 1,
"resource_url": "https://via.placeholder.com/150",
"callback_data": "xxx"
}'响应示例响应示例
{
"err_msg": "string",
"err_no": 0,
"log_id": "string",
"data": {
"resource_uri": "string"
}
}修改于 2025-11-12 07:28:47