查询设备列表

POST

/topapi/smartdevice/device/querylist

**
接口调用量说明**钉钉标准版接口累计可调用次数为1万次/月，当前接口会消耗调用次数。若该调用量无法满足需求，你可升级钉钉专业版(Open API调用量50万次/月)或钉钉专属版(Open API调用量500万次/月)扩容调用次数。

调用本接口分页查询企业下的智能设备列表。

重要

调用本接口之前，需要完成对接，否则无法正常调用。

请发送邮件至yuze.yl@alibaba-inc.com，并说明调用智能硬件接口的场景描述。

权限

服务端API是以应用维度授权的，在调用接口前，确保已经为应用添加了接口权限。

应用类型	是否支持调用	权限	API Explorer调试
企业内部应用	是	智能设备管理的基本权限	调试
第三方企业应用	是	智能设备管理的基本权限	调试
第三方个人应用	否	暂不支持	暂不支持

请求参数

Query 参数

Body 参数application/json

示例

返回响应

🟢200成功

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://oapi.dingtalk.com/topapi/smartdevice/device/querylist?access_token=6d1bxxxx' \
--header 'Content-Type: application/json' \
--data-raw '{
        "page_query_vo":{
                "cursor":0,
                "size":20,
                "pk":"pk_01"
        }
}'

响应示例

{
    "result": {
        "next_cursor": 0,
        "has_more": false,
        "list": [
            {
                "nick": "ding",
                "ext": "智能产品",
                "device_mac": "11.11.11.11",
                "device_name": "产品智能",
                "device_id": "QWR45GT",
                "pk": "pk_01",
                "sn": "sdx123d123asdf",
                "corp_id": "ding9f5xxxx",
                "userid": "user01"
            }
        ]
    },
    "errcode": 0,
    "success": true,
    "request_id": "exz1t52e9awo"
}

修改于 2024-01-25 03:39:33

查询设备列表

权限#

请求参数

返回响应

权限