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