软件开发工具包

API 服务平台 SDK 提供了 API 的请求封装和响应解释,
使用 SDK 可以轻松完成 API 的调用和 API 结果的获取,
SDK 包含更多 API 接口能力,可以更方便直接地调用 API 能力,
可实现在用户无感知的情况下查询 API 数据。

SDK 下载
工具包语言说明更新时间操作
iot-api-sdk-java-20180617.zipJava基于 JDK 7 开发2018/06/17下载
iot-api-sdk-csharp-20180617.zipC#基于 .NET Framework 4 开发2018/06/17下载
iot-api-sdk-php-20180617.zipPHP基于 PHP 7.3.1 开发2018/06/17下载
iot-api-sdk-ruby-20180617.zipRuby基于 Ruby 2.6.0 开发2018/06/17下载
iot-api-sdk-python-20180617.zipPython基于 Python 3 开发2018/06/17下载
iot-api-sdk-asp-20180617.zipASP基于 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资源下载,助你快速部署。