软件开发工具包
API 服务平台 SDK 提供了 API 的请求封装和响应解释，
使用 SDK 可以轻松完成 API 的调用和 API 结果的获取，
SDK 包含更多 API 接口能力，可以更方便直接地调用 API 能力，
可实现在用户无感知的情况下查询 API 数据。
SDK 下载
| 工具包 | 语言 | 说明 | 更新时间 | 操作 |
|---|---|---|---|---|
| iot-api-sdk-java-20180617.zip | Java | 基于 JDK 7 开发 | 2018/06/17 | 下载 |
| iot-api-sdk-csharp-20180617.zip | C# | 基于 .NET Framework 4 开发 | 2018/06/17 | 下载 |
| iot-api-sdk-php-20180617.zip | PHP | 基于 PHP 7.3.1 开发 | 2018/06/17 | 下载 |
| iot-api-sdk-ruby-20180617.zip | Ruby | 基于 Ruby 2.6.0 开发 | 2018/06/17 | 下载 |
| iot-api-sdk-python-20180617.zip | Python | 基于 Python 3 开发 | 2018/06/17 | 下载 |
| iot-api-sdk-asp-20180617.zip | ASP | 基于 ASP 3.0 开发 | 2018/06/17 | 下载 |
| iot-api-sdk-e-20180617.zip | 易语言 | 基于易语言 5.8 开发 | 2018/06/17 | 下载 |
SDK 使用
导入jar包
下载 SDK 压缩包后，内部包含 cmiot-api-sdk.jar 和 commons-logging.jar，将以上 jar 包导入项目中。
调用jar包
初始化一个CmiotClient实现类，
CmiotClient client = new DefaultCmiotClient("http://api.iot.10086.cn", "/v2/gprsrealtimeinfo");实例化一个具体接口Request对象，设置请求参数，
GprsRealTimeInfoRequest request = new GprsRealTimeInfoRequest();
request.setMsisdn("1064829750187");
request.setAppid("A0B40MY");
request.setEbid("0006000000336");
request.setPassword("1234");调用CmiotClient实现类中的excute方法，返回一个具体的Response对象，该对象封装了接口返回的数据。
GprsRealTimeInfoResponse response = client.excute(request);
使用示例
CMIOT_API2005－用户当月GPRS查询
CmiotClient client = new DefaultCmiotClient("http://api.iot.10086.cn", "/v2/gprsusedinfosingle");
request.setMsisdn("123456879");
request.setAppid("A0B40MI");
request.setEbid("0001000000403");
request.setPassword("1234");
GprsUsedInfoSingleResponse response = client.excute(request);CMIOT_API2009－短信批量查询
CmiotClient client = new DefaultCmiotClient("http://api.iot.10086.cn", "/v2/batchsmsusedbydate");
BatchSmsUsedByDateRequest request = new BatchSmsUsedByDateRequest();
request.setMsisdns("123456879_99999999");
request.setAppid("A0B40MI");
request.setEbid("0001000000403");
request.setPassword("1234");
request.setQuery_date("20171113");
BatchSmsUsedByDateResponse response = client.excute(request);对应接口
| 接口名称 | Constants类中常量名 |
|---|---|
| CMIOT_API2300-物联卡单日GPRS使用量查询 | GPRS_USED_INFO_SINGLE_BY_DATE |
| CMIOT_API2109-物联卡区域位置查询 | LOCATION_AREA |
| CMIOT_API2107-单个用户已开通服务查询 | USER_OPEN_SERVICE |
| CMIOT_API2106-集团各生命周期物联卡数量查询 | QUERY_CARD_COUNT |
| CMIOT_API2100-集团异常状态物联卡数据量查询 | QUERY_ABNORMAL_CARD_COUNT |
| CMIOT_API2101-集团GPRS在线物联卡数量查询 | GPRS_ONLINE_CARD_COUNT |
| CMIOT_API2102-物联卡短信服务开通查询 | QUERY_SMS_OPEN_STATUS |
| CMIOT_API2103-物联卡GPRS服务开通查询 | QUERY_GPRS_OPEN_STATUS |
| CMIOT_API2104-物联卡APN服务开通状态查询 | QUERY_APN_OPEN_STATUS |
| CMIOT_API2105-物联卡生命周期查询 | QUERY_CARD_LIFECYCLE |
| CMIOT_API2001-在线信息实时查询 | GPRS_REAL_SINGLE |
| CMIOT_API2002-用户状态信息实时查询 | USER_STATUS_REAL_SINGLE |
| CMIOT_API2003-码号信息查询 | CARD_INFO |
| CMIOT_API2008-开关机信息实时查询 | ON_AND_OFF_REAL_SINGLE |
| CMIOT_API2013-集团用户数查询 | GROUP_USER_INFO |
| CMIOT_API2022-欠费停机用户批量查询 | ARREARAGE_USER_INFO |
| CMIOT_API2011-用户余额信息实时查询 | BALANCE_REAL_SINGLE |
| CMIOT_API2005-用户当月GPRS查询 | GPRS_USED_INFO_SINGLE |
| CMIOT_API2009-短信批量查询 | BATCH_SMS_USED_BY_DATE |
| CMIOT_API2010-流量信息批量查询 | BATCH_GPRS_USED_BY_DATE |
| CMIOT_API2012-用户当月短信查询 | SMS_USED_INFO_SINGLE |
| CMIOT_API2014-用户短信使用查询 | SMS_USED_BY_DATE |
| CMIOT_API2020-套餐内GPRS流量使用情况实时查询 (集团客户) | GPRS_REALTIME_INFO_GROUP |
| CMIOT_API2037-物联卡资费套餐查询 | QUERY_CARD_PROD_INFO |
| CMIOT_API4001-短信状态重置 | SMS_STATUS_RESET |
对应接口
1、DefaultCmiotClient类实现两个方法，excute(CmiotRequest request)和excute(CmiotRequest request, String requestMethod)，若不带请求方法类型参数，则默认为POST请求。
2、CmiotClient的实现类都是线程安全的，所以没有必要每次API请求都新建一个CmiotClient实现类。
3、封装接口的请求参数时不需要设置transid和token，设置一个password，transid和token由appid和password生成。
4、commons-logging.jar与系统日志jar包如果有冲突，则请排除相应依赖。
5、JAVA SDK 需要依赖 Java SE/EE 1.7及以上 （不支持Android和IOS平台）。
开始使用
从产品简介，购买指导，操作指南，API参考，SDK资源下载，助你快速部署。