文档中心 > API类目 > 天猫精灵开放API

alibaba.ailabs.aligenie.opencontent.push (天猫精灵内容接入标准接口)

第三方内容接入天猫精灵内容库,供相关技能使用

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
skill_id Number 必须 5588 在Aligenie开放平台创建的技能的ID
contents BatchContent 必须 详细内容列表
  • └ category_id
  • Number
  • 必须
  • 80001
  • 类目ID,具体参见开放平台类目相关描述
  • open_contents
  • OpenContent []
  • 必须
  • 内容信息
  • └ album_raw_id
  • Number
  • 可选
  • 1001
  • 内容在原平台所属专辑或分类的id
  • └ tags
  • String []
  • 可选
  • 流行
  • 内容标签
  • └ raw_id
  • Number
  • 必须
  • 100101
  • 内容在原平台的id,当只推送专辑信息时,此值可填0
  • image_url
  • ImageUrl
  • 可选
  • 封面图片信息
  • └ mediam
  • String
  • 可选
  • http://mediam.png
  • 中图链接(具体大小范围暂无标准,接入方自定)
  • └ small
  • String
  • 可选
  • http://small.png
  • 小图链接(具体大小范围暂无标准,接入方自定)
  • └ large
  • String
  • 可选
  • http://large.png
  • 大图链接(具体大小范围暂无标准,接入方自定)
  • └ remark
  • String
  • 可选
  • remark
  • 备注
  • └ album_title
  • String
  • 可选
  • 七日歌
  • 内容所属专辑或分类名称/标题,这里如果专辑标题是空则不同步专辑信息
  • └ extend_info
  • String
  • 可选
  • {region:"杭州", content:"杭州新闻", source:"新华社"}
  • 其他扩展字段,不同类型内容有不同要求,具体请参加详细说明文档extend_info字段部分
  • └ operation
  • String
  • 必须
  • ADD
  • 操作方式,支持新增和删除操作(ADD/DELETE)
  • author
  • Author
  • 可选
  • 作者信息
  • └ content_author
  • String
  • 可选
  • 李想
  • 内容作者,对应音乐为作词、作曲人,对应小说故事为原著作者
  • └ voice_author
  • String
  • 可选
  • 李念
  • 主播,演唱者,演播者
  • └ title
  • String
  • 可选
  • 第一天的故事
  • 内容标题或者名称,最长150个字符
  • └ duration
  • Number
  • 必须
  • 1231
  • 播放时长(单位:秒)
  • └ play_count
  • Number
  • 必须
  • 100212
  • 内容在原平台播放次数
  • └ description
  • String
  • 可选
  • description
  • 内容描述信息(限长500)
  • └ release_time
  • Number
  • 必须
  • 1515326176
  • 内容发布时间,1970年1月1日至当前的秒数(unix时间戳)
  • play_urls
  • PlayUrl []
  • 可选
  • 播放链接
  • └ bitrate
  • Number
  • 可选
  • 128
  • 码率
  • └ url
  • String
  • 可选
  • http://adad.mp3
  • 可播放链接
  • └ type
  • String
  • 可选
  • audio
  • 节目音视频类型,目前支持audio及video两种类型
  • └ album_description
  • String
  • 可选
  • album_description
  • 内容所属专辑或分类描述信息
  • └ sort_num
  • Number
  • 可选
  • 1
  • 在有所属专辑/分类的场景下,标识此音频在专辑/分类下的顺序值,从1开始
  • └ description_type
  • String
  • 可选
  • TTS
  • 描述类型,如果描述是TTS类型会做TTS处理
  • └ hot_score
  • Number
  • 可选
  • 5
  • 三方热度分1~5

响应参数

名称 类型 示例值 描述
result Result result
  • └ ret_msg
  • String
  • 操作成功
  • retMsg
  • └ ret_code
  • Number
  • 200
  • retCode

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAilabsAligenieOpencontentPushRequest req = new AlibabaAilabsAligenieOpencontentPushRequest();
req.setSkillId(5588L);
AlibabaAilabsAligenieOpencontentPushRequest.BatchContent obj1 = new AlibabaAilabsAligenieOpencontentPushRequest.BatchContent();
obj1.setCategoryId(80001L);
List<AlibabaAilabsAligenieOpencontentPushRequest.OpenContent> list3 = new ArrayList<AlibabaAilabsAligenieOpencontentPushRequest.OpenContent>();
AlibabaAilabsAligenieOpencontentPushRequest.OpenContent obj4 = new AlibabaAilabsAligenieOpencontentPushRequest.OpenContent();
list3.add(obj4);
obj4.setAlbumRawId(1001L);
obj4.setTags("流行");
obj4.setRawId(100101L);
AlibabaAilabsAligenieOpencontentPushRequest.ImageUrl obj6 = new AlibabaAilabsAligenieOpencontentPushRequest.ImageUrl();
obj6.setMediam("http://mediam.png");
obj6.setSmall("http://small.png");
obj6.setLarge("http://large.png");
list5.setImageUrl(obj6);
obj4.setRemark("remark");
obj4.setAlbumTitle("七日歌");
obj4.setExtendInfo("{region:\"杭州\", content:\"杭州新闻\", source:\"新华社\"}");
obj4.setOperation("ADD");
AlibabaAilabsAligenieOpencontentPushRequest.Author obj8 = new AlibabaAilabsAligenieOpencontentPushRequest.Author();
obj8.setContentAuthor("李想");
obj8.setVoiceAuthor("李念");
list7.setAuthor(obj8);
obj4.setTitle("第一天的故事");
obj4.setDuration(1231L);
obj4.setPlayCount(100212L);
obj4.setDescription("description");
obj4.setReleaseTime(1515326176L);
List<AlibabaAilabsAligenieOpencontentPushRequest.PlayUrl> list11 = new ArrayList<AlibabaAilabsAligenieOpencontentPushRequest.PlayUrl>();
AlibabaAilabsAligenieOpencontentPushRequest.PlayUrl obj12 = new AlibabaAilabsAligenieOpencontentPushRequest.PlayUrl();
list11.add(obj12);
obj12.setBitrate(128L);
obj12.setUrl("http://adad.mp3");
obj12.setType("audio");
list9.setPlayUrls(list11);
obj4.setAlbumDescription("album_description");
obj4.setSortNum(1L);
obj4.setDescriptionType("TTS");
obj4.setHotScore(5L);
obj1.setOpenContents(list3);
req.setContents(obj1);
AlibabaAilabsAligenieOpencontentPushResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_ailabs_aligenie_opencontent_push_response>
    <result>
        <ret_msg>操作成功</ret_msg>
        <ret_code>200</ret_code>
    </result>
</alibaba_ailabs_aligenie_opencontent_push_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案
400 接口调用错误 联系天猫精灵内容接入平台解决

API工具

如何获得此API

FAQ

返回
顶部