1、接口说明

设备通过物模型对接后，可以通过以下接口获取当前项目中的各类设备数据。

2、接入指南

通过queryAppThingList接口作为接入范例，通过productKey可以获取到其下所有的设备列表、设备状态与设备类型等信息。

入参：

出参：

示例

入参示例**

{
    "request": {
        "apiVer": "1.0.0"
    },
    "id": "bfd7388e-b6ec-4abd-8832-e6a4ea5b2cbd",
    "params": {
        "productKeyList": ["xxxx"],
        "pageSize": 20,
        "pageNo": 1,
        "categoryKeyList": [],
        "tagList": []
    },
    "version": "1.0"
}

出参示例

{
    "code": 200,
    "data": {
        "total": 1,
        "data": [{
            "activeTime": "2019-10-15 13:11:49",
            "productKey": "xxxxxx",
            "nodeType": 0,
            "deviceName": "ColdRiver01",
            "utcCreateTime": "2019-10-15T03:45:36.000Z",
            "productName": "xxxxx",
            "utcActiveTime": "2019-10-15T05:11:49.658Z",
            "utcLastOnlineTime": "2019-10-16T03:27:46.604Z",
            "createTime": "2019-10-15 11:45:36",
            "lastOnlineTime": "2019-10-16 11:27:46",
            "status": "OFFLINE"
        }],
        "pageNo": 1,
        "pageSize": 20
    },
    "id": "18b32d34-0808-4ebd-b61b-79572a484535"
}

3、API调用方式

SDK依赖

本例通过java版本的sdk进行描述，更多语言SDK详情请查看API调用对接指引

<dependency>
            <groupId>com.aliyun.api.gateway</groupId>
            <artifactId>sdk-core-java</artifactId>
            <version>1.1.0</version>
        </dependency>
        <dependency>
            <groupId>com.aliyun.iotx</groupId>
            <artifactId>iotx-api-gateway-client</artifactId>
            <version>1.0.3</version>
</dependency>

3.2 示例代码

public void propertiesTimeline() throws  UnsupportedEncodingException{
        IoTApiClientBuilderParams ioTApiClientBuilderParams =
                new IoTApiClientBuilderParams();
        // 填写应用的appkey信息
        ioTApiClientBuilderParams.setAppKey("appKey");
        ioTApiClientBuilderParams.setAppSecret("appSecrect");
        SyncApiClient syncClient = new SyncApiClient(ioTApiClientBuilderParams);
        IoTApiRequest request = new IoTApiRequest();
        //设置api的版本
        request.setApiVer("1.0.0");
        // 接口参数
        request.putParam("productKey","xxxxxx");
        request.putParam("deviceName","xxxxxx");
        request.putParam("identifier","OilQuantity");
        request.putParam("pageSize",20);
        //start与end是查询的时间范围，时间戳格式，精确到毫秒
        request.putParam("start","1571022916629");
        request.putParam("end","1571162916629");
        request.putParam("ordered",false);
        request.setVersion("1.0");// 请求协议版本
        ApiResponse response = syncClient.postBody("api.link.aliyun.com",
                "/app/thing/property/timeline/get", request, true);
        System.out.println("response code = " + response.getCode()
                + " response = " + new String(response.getBody(), "UTF-8"));
    }