开发
API

【泛知识】课程库 FAQ

开发者在 oncall 之前,需认真阅读此文档,若仍无法解决可发起 oncall。

1.为什么资源上传已经获得了 uri,仍然报“无效的 uri,uri 不存在”?

在泛知识课程库中的资源上传是异步执行的,即:先获取 uri,后上传资源,获得 uri 并不代表已经上传成功。

因此,若有以下情况,则会报这个错误:

  1. 上传文件过大,异步上传需要一定时间,在上传成功前,uri 都是无效的;
  2. 在小概率情况下(资源上传高峰期,资源链接限制访问或下载),资源有可能上传失败,此时,uri 无效。

对于以上情况,可以先通过资源上传状态查询接口来确定资源上传状态(状态码 1 代表正在上传,2 代表成功,3 代表失败),或通过开发者信息回调接口来获取信息。若资源正在上传,则可等待一段时间后再次确认;若资源上传失败,则可以选择上传非高峰期重试。

2.为什么我的接口返回为空?

返回为空,应当先查看返回的 HTTP 状态码,此时,状态码一般为 400。出现该情况的原因一般是请求字段有误,如将 string 写成 number 之类。

这里整理了一些常见错误情况:

接口

易错字段

备注

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

http://developer-product.zijieapi.com/product/api/modify

product->common_product_params->path_info_lst->query

query字段所包含的应当是string到string的映射,往期oncall中发现开发者容易写成string到number的映射

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

http://developer-product.zijieapi.com/product/api/modify

product->common_product_params->first_class

这里first_class和second_class都应该是number,部分开发者容易错填成string

3.课程进审之后,还可以重新进审吗?

可以,主要分一下几种情况:

  1. 已经进审,尚未获得审核结果,此时调用课程修改接口,则取消之前进审,重新发起审核;
  2. 非初次进审,即调用修改接口之前,课程已经过审至少一次,此时调用修改接口,走正常修改审核流程;
  3. 初次进审,即该课程为新添加课程,且审核未通过,此时不能调用修改接口,需要调用添加接口重新获取 product_id。

4.为什么上传资源的时候,显示“无效的资源上传类型”,但链接后缀的类型和支持类型是匹配的?

这里需要注意:url 文件的类型不是由后缀决定的,而是由 GET 请求 header 中的 content-type 决定的,开发者在上传之前应当确认好自己的文件类型是否匹配。

目前支持的各类 content-type 如下:

图片

image/jpeg、image/jpg、image/png

视频

video/mp4、video/mpeg、video/x-msvideo、video/quicktime、application/x-mpegURL、application/vnd.apple.mpegurl

音频

audio/mpeg、audio/wav、audio/x-wav、audio/x-m4a、audio/x-hx-aac-adts、audio/mp3

5. 显示报错信息太奇怪,如明明写了 appid,却仍然显示 appid 缺失,是为什么?

这类问题往往与请求关键字段缺失或字段拼写有误有关,若有这种情况,会影响 json 解析,从而影响后端实际收到的字段,导致报错信息与实际错误相差万里。遇到这种情况,请先仔细检查请求字段是否有误。

6.丢失了 product_id 或 audit_task_id,应该怎么办?

这两个 id 非常重要,开发者获取后应当认真保管。在发现 id 丢失后,应当优先在日志中排查,若确无法找到,可在提供充足关键信息(appid、课程名、审核时间、课程路径等)后联系 oncall 帮忙找回。

7.我的课程被驳回了,理由是“无实质内容”,应该怎么办?

这类问题有可能是开发者字段填写有误,导致审核侧无法获取充分信息而导致的。出现此类问题时,开发者应首先对照文档确认自己的请求字段填写,如确无错误,则是业务问题,请直接在 oncall 群或社区联系产运进行咨询。

8.开发者是否一定要接入课程库?

是,为保障用户体验一致性,开发者需要接入课程库。

9.开发者存量课程是否要入库?

是,所有课程(存量+增量)都要接入课程库。

10.为什么要审核课程?

为避免违法不良信息传播,保障用户消费体验,平台将对入库课程及讲者资质等信息进行审核。

11.开发者课程审核时效是多久?

按照课程入库顺序陆续审出。

12.开发者课程状态是否有主动通知?

暂时没有,只能以进行查询,主动通知的能力仍在建设中,后续会进行公示。

13.开发者课程资质如何上传?

暂时以 老师现有资质 进行上传,资质标准与上传流程仍在建设中,后续会进行公示。

14.开发者课程资源里有多个视频应该怎么上传?

多次调用分开上传。

15.开发者课程接入中技术问题如何解决?

请先按照接口返回的失败的错误码,对照文档查询是哪些参数格式不符合规范并进行修改,如果都不是,请通过社区进行反馈。

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