dingtalk.corp.device.manage.querylist (拉取企业下某类设备列表)

此接口用于展示企业已经绑定的设备列表(分页接口)

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
device_service_id Number 必须 14 设备服务商ID
cursor Number 必须 0 分页拉取设备列表的游标,首次拉取可传Null或者0
size Number 必须 20
  • 最大值:20
  • 单次请求的大小,最大不超过20

    响应参数

    名称 类型 示例值 描述
    result DingOpenResult 返回结果
    • result
    • PageVo
    • 返回的Page对象
    • list
    • OpenDeviceVo []
    • 设备列表
    • └ nick
    • String
    • 考勤机A
    • 设备昵称
    • └ device_id
    • String
    • ding1234
    • 设备ID
    • └ avatar
    • String
    • http://xxxxx
    • 设备头像
    • └ device_type_name
    • String
    • 德力考勤机
    • 设备类型名称
    • └ on_line_status
    • Number
    • 1
    • 设备在线状态{1:在线,0:不在线}
    • └ device_sn
    • String
    • 0202APW170201N023571
    • 设备SN
    • └ device_mac
    • String
    • 设备MAC地址
    • └ next_cursor
    • Number
    • 10000
    • 下次拉取列表的游标,如果为Null,代表没有数据了
    • └ error_msg
    • String
    • success
    • 错误信息
    • └ ding_open_errcode
    • Number
    • 0
    • 错误码
    • └ success
    • Boolean
    • true
    • request是否成功

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    DingTalkClient client = new DefaultDingTalkClient("https://eco.taobao.com/router/rest");
    CorpDeviceManageQuerylistRequest req = new CorpDeviceManageQuerylistRequest();
    req.setDeviceServiceId(14L);
    req.setCursor(0L);
    req.setSize(20L);
    CorpDeviceManageQuerylistResponse rsp = client.execute(req, access_token);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <dingtalk_corp_device_manage_querylist_response>
        <result>
            <result>
                <list>
                    <open_device_vo>
                        <nick>考勤机A</nick>
                        <device_id>ding1234</device_id>
                        <avatar>http://xxxxx</avatar>
                        <device_type_name>德力考勤机</device_type_name>
                        <on_line_status>1</on_line_status>
                        <device_sn>0202APW170201N023571</device_sn>
                        <device_mac></device_mac>
                    </open_device_vo>
                </list>
                <next_cursor>10000</next_cursor>
            </result>
            <error_msg>success</error_msg>
            <ding_open_errcode>0</ding_open_errcode>
            <success>true</success>
        </result>
    </dingtalk_corp_device_manage_querylist_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

    返回
    顶部