文档中心 > API类目 > 智能设备

alibaba.ailabs.aligenie.albums.search (查询专辑)

搜索类目下的专辑信息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
schema String 可选 36653b6e-f41a-11e6-bc64-92361f00267 账户体系隔离
user_id String 可选 13911112222 用户ID,此处传入第三方账户体系的用户id
utd_id String 可选 V944n0HrnZ4DAAtOStvvDat7 用户设备唯一识别码,长度限制32以内,建议使用系统接口获取deviceid,然后做一定的混淆处理来作为此输入参数
ext String 可选 {"appType":"IOS","appVersion":"1.0"} 扩展信息,用于存放APP类型等
param1 String 可选 儿童 一级类目,如:儿童、新闻、商业财经有声书等
param2 String 可选 儿歌 二级类目,如儿童下有:儿歌、童谣、国学等
param3 String 可选 音乐故事 搜索的单个专辑名称
param4 Number 必须 1 当前页(从1开始, 目前由于底层引擎限制,实际最多能查5000个,超过5000返回为空,请确保页码*分页大小不超过5000)
param5 Number 必须 10 每页数量(不超过50)

响应参数

名称 类型 示例值 描述
result AiCloudResult result
  • └ record_count
  • Number
  • 6100
  • 总共符合数据的个数(目前由于底层引擎限制,实际最多能查5000个,超过5000返回为空)
  • └ model
  • String
  • []
  • List数据结构,List中的每一个条目是一个Map对象,key为属性名称,value为对应的值
  • └ msg_code
  • String
  • SUCCESS
  • 返回码
  • └ msg_info
  • String
  • 成功
  • 返回信息
  • └ success
  • Boolean
  • true
  • 请求是否成功
  • └ extend_info
  • String
  • {}
  • 额外扩展信息,JSON串,不一定有

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAilabsAligenieAlbumsSearchRequest req = new AlibabaAilabsAligenieAlbumsSearchRequest();
req.setSchema("36653b6e-f41a-11e6-bc64-92361f00267");
req.setUserId("13911112222");
req.setUtdId("V944n0HrnZ4DAAtOStvvDat7");
req.setExt("{\"appType\":\"IOS\",\"appVersion\":\"1.0\"}");
req.setParam1("儿童");
req.setParam2("儿歌");
req.setParam3("音乐故事");
req.setParam4(1L);
req.setParam5(10L);
AlibabaAilabsAligenieAlbumsSearchResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_ailabs_aligenie_albums_search_response>
    <result>
        <record_count>6100</record_count>
        <model>[]</model>
        <msg_code>SUCCESS</msg_code>
        <msg_info>成功</msg_info>
        <success>true</success>
        <extend_info>{}</extend_info>
    </result>
</alibaba_ailabs_aligenie_albums_search_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>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部