软件开发工具包
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资源下载,助你快速部署。