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

taobao.ailab.aicloud.call.contact.ext.contact.info.list.query (分页查询三方通讯录列表)

查询开放通讯录列表

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
service_name String 必须 test_china_unicom_voip_call 接入通话的服务名称,同一个服务名称下的设备之间才允许通话,品key,由天猫精灵分配给三方(测试和线上环境不同)
owner_ext_user_id String 必须 01MLnDVSANVwCRaIMp2cfryQ 三方用户唯一标识
owner_product_key String 必须 b1ZLOhA9rF7 产品key,由天猫精灵分配给三方,每个设备类型分配一个
owner_device_name String 必须 00-16-EA-AE-3C-40 设备名称,DeviceName通常与ProductKey组合使用,用作标识具体的唯一设备。
offset Number 必须 0 偏移量
limit Number 必须 10 单次查询数据量

响应参数

名称 类型 示例值 描述
call_contact_info_list CallContactInfo [] [] 开放通讯录列表
  • └ contact_device_name
  • String
  • 联系对象为设备时不为空,联系设备在阿里云物联网平台的设备名称
  • └ contact_ext_user_id
  • String
  • 01MLnDVSANVwCRaIMp2cfryQ
  • 联系对象为用户时不为空,三方用户唯一标识
  • └ contact_img
  • String
  • https://xxx
  • 联系对象图像
  • └ contact_nickname
  • String
  • 张三
  • 联系对象昵称
  • └ contact_phone_num
  • String
  • 联系对象号码
  • └ contact_product_key
  • String
  • 联系对象为设备时不为空,联系设备在阿里云物联网平台的产品key
  • └ contact_type
  • String
  • User
  • 联系对象类型(USER: 用户,DEVICE: 设备)

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AilabAicloudCallContactExtContactInfoListQueryRequest req = new AilabAicloudCallContactExtContactInfoListQueryRequest();
req.setServiceName("test_china_unicom_voip_call");
req.setOwnerExtUserId("01MLnDVSANVwCRaIMp2cfryQ");
req.setOwnerProductKey("b1ZLOhA9rF7");
req.setOwnerDeviceName("00-16-EA-AE-3C-40");
req.setOffset(0L);
req.setLimit(10L);
AilabAicloudCallContactExtContactInfoListQueryResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<ailab_aicloud_call_contact_ext_contact_info_list_query_response>
    <call_contact_info_list>
        <call_contact_info>
            <contact_device_name></contact_device_name>
            <contact_ext_user_id>01MLnDVSANVwCRaIMp2cfryQ</contact_ext_user_id>
            <contact_img>https://xxx</contact_img>
            <contact_nickname>张三</contact_nickname>
            <contact_phone_num></contact_phone_num>
            <contact_product_key></contact_product_key>
            <contact_type>User</contact_type>
        </call_contact_info>
    </call_contact_info_list>
</ailab_aicloud_call_contact_ext_contact_info_list_query_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

返回
顶部