开发
API

【泛知识】上传课程资源

API 说明

该接口用于上传课程资源,在调用课程上传接口前,需要先使用这个课程资源上传接口拿到返回的资源 uri。

使用限制

因为课程资源文件往往比较大,平台提供的带宽相对比较有限,如果需要大批量上传课程资源,请保证上传 QPS 不大于 50。

接口说明

上传资源后会立即得到一个 uri,但实际上资源上传为异步过程,如果上传资源后立即上传课程资源,可能会导致找不到该 uri 而导致该课程上传失败。需要获取所有资源上传回调通知成功的状态后,或者通过查询课程资源上传状态接口确认所有 uri 都上传成功后,再上传课程/资质,资源上传详细流程:

基本信息

HTTP URL

https://developer-product.zijieapi.com/product/api/upload_resource

HTTP Method

POST

权限要求

AccessToken鉴权

请求头

名称

类型

是否必填

描述

示例

Content-Type


string

请求的MIME类型,统一为application/json

"application/json"


请求参数

名称

类型

是否必填

描述

示例

access_token

string

接口调用凭证

"0801121846735352506a356a67395167574457583155554e67654321"

appid

string

小程序id

"tt12fd9846e1023401"

resource_type

enum

资源类型,详见下方resource_type枚举

1

resource_url

string

资源url链接

"https://via.placeholder.com/150"

请求示例

{
  "access_token": "0801121846735561486f5a48744d744157456a554a68446d52773d3d",
  "appid": "tt77fd0140e89bba8401",
  "resource_type": 1,
  "resource_url": "https://via.placeholder.com/150"
}

响应参数

名称

类型

描述

示例值

err_no

number

错误码,0为成功

0

err_msg

string

错误内容

"success"

log_id

string

日志id,用于查询错误

"101210271802130982251451520919C123"

data

object

返回数据,成功后返回资源uri,开发者需要将uri记录下来,在调用上传/修改课程,上传/修改资质接口时使用

{

    "resource_uri": "product/resource/dasdkfji1343t879l23"

}

data--返回数据

名称

类型

描述

示例值

resource_uri

string

资源uri

"product/resource/dasdkfji1343t879l23"

响应示例

正常示例

// 非交易展示图片响应,uri开头为"product/resource/"
{
    "err_msg": "success",
    "err_no": 0,
    "log_id": "2021122911185801022524315301123456",
    "data" {
        "resource_uri": "product/resource/dasdkfji1343t879l23"
    }
}

// 交易展示图片响应,uri开头为"tos-cn-i-b2i6zad4el/"
{
    "err_msg": "success",
    "err_no": 0,
    "log_id": "2022042818505701014108303218E00144",
    "data": {
        "resource_uri": "tos-cn-i-b2i6zad4el/b0e72a2e9c5ee919c65a9b0276315cf9"
    }
}

异常示例

{
  "err_msg": "商品资源大小超过限制",
  "err_no": 10037,
  "log_id": "2021122911185801022524315301123456"
}

枚举参数

resource_type--资源类型

课程相关

资源类型

资源类型编码

文件限制大小

文件格式要求

商品详情图片

1

<= 50MB

jpeg、jpg、png

商品视频履约内容

2

<= 5GB

mp4、mpeg、mov

商品音频履约内容

3

<= 5GB

mp3、wav、m4a

商品图片履约内容

4

<= 50MB

jpeg、jpg、png

商品其他履约内容

100

<= 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

点击纠错
该文档是否对你的开发有所帮助?
有帮助
没帮助
该文档是否对你的开发有所帮助?
有帮助
没帮助