【泛知识】上传课程资源
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 |