一．登录阿里百川无线开放平台，创建应用，获得 appKey

登录淘宝开放平台后，创建应用，选择‘百川无线应用’，获得 appKey。

创建成功后，登录淘宝开放平台，点击已创建应用的‘应用管理’按钮，在页面内的‘功能场景’栏中申请‘天猫精灵内容库API’权限(如未发现此 API 权限，请联系对接人员线下申请)。

二．登录AliGenie开发者平台，创建技能

创建技能链接：https://iap.aligenie.com/console/skill/list

选择技能类型为“内容”，选择相应技能模板，并填写好其他信息。点击下一步，并在“API 接入”信息填写界面按要求补充信息：

待填写信息包括：

1. 第一步淘宝开放平台所创建应用的 appKey，必填，可修改；
2. 接入方自定义身份标识 ID（数字字母下划线），必填项，值唯一，不可修改；
3. 接入方名称，必填项，不可修改；
4. 播放链接查询回调接口，非必填（如需要通过回调查询播放链接，请参考下述播放链接回调说明）；
   填写完成后保存。

三．按照API文档接入系统

等待步骤一中权限申请审核通过，即可通过淘宝开放平台“应用管理-SDK下载-服务端SDK”页面下载SDK包进行接口开发。

按照 类目-专辑-音频 的结构关系，设计如下接口。其中类目信息需要三方平台自行对应到‘AliGenie 开发者平台’中已有的类目信息（如需新增类目需要提交审核），专辑和音频结构信息由三方平台自行组织好后传入。

API 入参字段说明

详见淘宝开放平台天猫精灵内容库API接口调用说明。

其中关于 extend_info 字段的填写说明如下所示。

extend_info 字段说明

extendInfo 作为扩展字段，为 JSON 格式，详细字段信息如下:

1. 版权相关信息，请在 extendInfo 中填写 limitRegion 字段

2.内容分级

3. extendInfo 作为各个不同类型内容输入的扩展字段，根据不同的内容类型输入字段有所不同：

• 新闻类型：

• 儿童内容类型：

• AR 绘本内容：

其中 cdnUrl 为 AR 绘本图片地址链接，position 标明是绘本的左页或者右页，pageNum 表示绘本的页数。

API 响应字段说明

成功响应:

失败响应:

附1：播放链接回调说明：

播放链接查询回调接口是在内容方不提供固定的播放地址，需要实时获取播放地址的情况下需要填写的，由用户选填。调用该接口时将会使用平台私钥对请求进行签名，接入方需要使用平台公钥对签名进行验证。

播放链接查询回调接口需接收以下请求参数：

播放链接查询接口应当返回包含播放链接信息的 List 类型，数据格式如下：

签名过程：

组合字符串 sourceId + albumId (若存在) + contentId + requestTime + randomId，开放平台将对该字符串使用平台私钥进行 SHA1withRSA 签名加密，对加密结果进行 Base64 编码得到签名字段 signature 连同其它参数一同传递给接入方。

服务端收到请求后，请使用开放平台提供的公钥对签名进行验证。（为了防止重复请求攻击，服务端可对请求参数 requestTime 及 randomId 进行识别，当收到的 requestTime 值比上一个小 10 秒则认为非法，其次每个请求的 requestTime 与 randomId 拼接后的字符串必须是唯一的）

签名验证代码示例(Java)

Signature mySig = Signature.getInstance("SHA1withRSA");
String pbkeyStr = "";
X509EncodedKeySpec keySpec = new X509EncodedKeySpec(Base64.getDecoder().decode(pbkeyStr));
PublicKey pb = f.generatePublic(keySpec);
mySig.initVerify(pb);
mySig.update(parametersStr.getBytes("UTF-8"));
if(mySig.verify(Base64.getDecoder().decode(signature))){
    //TODO
}

附2：类目名称及 ID 对应关系

• 新闻类目

• 儿童

• 绘本

• 娱乐

• 有声书

• 音乐