【泛知识】课程库 FAQ

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

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

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

因此，若有以下情况，则会报这个错误：

上传文件过大，异步上传需要一定时间，在上传成功前，uri 都是无效的；

在小概率情况下（资源上传高峰期，资源链接限制访问或下载），资源有可能上传失败，此时，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.课程进审之后，还可以重新进审吗？

可以，主要分一下几种情况：

已经进审，尚未获得审核结果，此时调用课程修改接口，则取消之前进审，重新发起审核；

非初次进审，即调用修改接口之前，课程已经过审至少一次，此时调用修改接口，走正常修改审核流程；

初次进审，即该课程为新添加课程，且审核未通过，此时不能调用修改接口，需要调用添加接口重新获取 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.开发者课程接入中技术问题如何解决？

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

附录（开发者服务支持）

如在开发中遇到问题，开发者可通过 IM 客服、工单、社区等方式获取抖音开放平台的服务支持。

1、IM 客服（推荐）

机器人智能回复，技术支持及时应答，更高效的解答开发者在注册认证、应用上下架、开放能力接入等工作过程中遇到的问题。最快可在 1 分钟获得官方回复，在线服务时间为 10:00 - 19:00

使用指引

如下图所示，在网站右下角点击在线咨询；

判断推荐问题是否相关，如果相关，直接点击对应的词条，直至找到想要的答案；

如果没有得到想要的答案，回复「人工」，获得技术支持的帮助；

如果技术支持无法解答，回复「工单」，提交相关问题，即可获得官方客服的帮助

2、技术工单

如遇 IM 客服无法解决的技术问题，可提交技术工单，官方答复时间为 1-3 个工作日

使用指引

工单的提交需要按照上述步骤执行；

已经发起的工单可以在右下角点击工单记录查看官方的回复

3、开发者社区

抖音开放平台开发者社区包含经验分享、官方公告、常见问题汇总等，用户可通过社区发帖提问，官方将在1-3个工作日解答（https://developer.open-douyin.com/forum ）

【泛知识】课程库 FAQ

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

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

3.课程进审之后，还可以重新进审吗？#

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

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

6.丢失了 product_id 或 audit_task_id，应该怎么办？#

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

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

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

10.为什么要审核课程？#

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

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

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

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

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

附录（开发者服务支持）#