aliyun / iotx-api-gateway-client

阿里云物联网平台API调用示例

介绍

阿里云IoT网关，旨在通过http/https协议将物联网平台及衍生服务开放给开发者。本文档主要介绍如何访问阿里云IoT网关。IoT网关依赖阿里云API网关，IoT网关在阿里云API网关的基础上扩展了IoT的特殊业务协议。

协议框架

    {
        "id": "1509086454180",
        "version": "1.0",
        "request": { },
        "params": { }
    }

id: 一次请求的标示，用于请求跟踪问题排查，通常用UUID生成
version: 协议版本，当前版本1.0
request: JSON对象，与业务无关的通用参数，包括如下可用参数

apiVer:API版本 必填
iotToken:登录用户的token（客户端） 非必填
cloudToken:云端资源token（云端） 非必填
language:国际化扩展，语言。 非必填
locale:国际化扩展，地理位置、ip。 非必填

params: JSON对象，访问指定api的业务参数

示例

假设您需要访问IoT网关提供的如下API：
定义描述

    path:/awss/enrollee/list/get
    版本:1.0.2
    描述:分页查询发现设备列表，用于配网流程
    鉴权:是，客户端SDK需启用身份的鉴权

请求参数

参数名称:pageSize,参数类型:Integer,是否必填:是,描述:分页大小
参数名称:pageNum,参数类型:Integer,是否必填:是,描述:页编号

请求示例 版本1.0.2对应request中的apiVer，由于API要求用户身份验证，request中必须包含参数iotToken。请求参数统一放到params中。

{
    "id": "1509086454180",
    "version": "1.0",
    "request": {
        "apiVer": "1.0.2",
        "iotToken": "token"
    },
    "params": {
        "pageSize": 10,
        "pageNum": 1
    }
}

假设您已经拥有了访问IoT网关的appKey和appSecret 分别为appkey1和appsecret1，通过IoT网关访问如下：

        IoTApiClientBuilderParams ioTApiClientBuilderParams = new IoTApiClientBuilderParams();

        ioTApiClientBuilderParams.setAppKey("xxxx");
        ioTApiClientBuilderParams.setAppSecret("xxxxxxxxxx");

        SyncApiClient syncApiClient = new SyncApiClient(ioTApiClientBuilderParams);

        IoTApiRequest request = new IoTApiRequest();
        //设置协议版本号
        request.setVersion("1.0");
        String uuid = UUID.randomUUID().toString();
        String id = uuid.replace("-", "");
        //设置请求ID
        request.setId(id);
        //设置API版本号
        request.setApiVer("1.0.2");
        //如果需要登陆，设置当前的会话的token，token通过登录api获取
        request.setIoTToken("token");
        //设置参数
        request.putParam("pageSize", 10);
        request.putParam("pageNum", 1);

        Map<String, String> headers = new HashMap<>(8);

        //设置请求参数域名、path、request ,如果使用HTTPS，设置为true
        ApiResponse response = syncApiClient.postBody("api.link.aliyun.com", "/awss/enrollee/list/get", request, true, headers);

        System.out.println( "response code = " + response.getCode() + " response = " + new String(response.getBody(), "UTF-8"));

依赖

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