PDF《智运开放平台》

智运开放平台 技术白皮书 北京中交兴路车联网科技有限公司

2018 年12 月 模板编号 中交兴路车联网―智运 文档版本号 V2.

16 文档变更履历 变更内容 版本 创建/变更时间 车辆位置接口查询指定定位时间范围,单位:小时 V1.1 2017-05-17 更正接口返回 JSON 示例 V1.2 2017-06-08 更正回调通知接口参数定义 V1.3 2017-06-12 更新找车接口车长参数 V1.4 2017-06-23 新增:车辆里程查询、车辆停车查询、道路运输证验 证、车辆行驶证信息查询、下发车机信息 V1.5 2017-07-07 新增:逆地理信息查询 V1.6 2017-07-11 更正行驶证返回值示例 V1.7 2017-07-20 新增:道路运输证查询接口、发布货源短信接口 V1.8 2017-08-11 新增:车辆在途运抵预判接口、车辆签到接口、车辆 确认接口.车辆最新位置(车牌号、车架号) 、多车最 新位置等接口增加省市县 V1.9 2017-09-12 新增:车辆运营数据查询接口 V2.0 2017-10-30 回调接口增加 token 动态令牌 V2.1 2017-11-28 去除下发车机接口 V2.2 2018-01-04 找车接口新增车辆类型,支持同一辆车多种类型 V2.3 2018-01-18 更新 SDK 示例代码 V2.4 2018-03-01 更新常见问题 V2.5 2018-03-02 更新轨迹接口时间参数 V2.6 2018-03-23 新增:车辆业务数据查询、企业运力评估、 车辆运力评估 (车牌号) 、 车辆运力评估 (车架号) 、 车 辆信息查询(车牌号) 、车辆信息查询(车架号) V2.7 2018-04-18 更新找车接口,增加精准找车、周边找车 v2.8 2018-05-30 增加驶入驶出多边形区域注册接口 v2.9 2018-08-30 找车接口增加货物类型非必填查询参数,增加找车行 政区划编码附录对照 v2.10 2018-09-05 增加精准找车接口 V4.0 和周边找车接口 V5.0 v2.11 2018-09-07 更正精准找车接口 V4.0 和周边找车接口 V5.0 参数 v2.12 2018-09-18 找车接口顺序调整和增加排放标准验证接口 v2.13 2018-09-21 新增周边找车接口 V6.0 和精准找车接口 V7.0 (比精准找车接口 V4.0 和周边找车接口 V5.0 调整了 车辆类型的传入传出参数) V2.14 2018-09-29 车辆行驶证信息查询:添加返回值车轴数 V2.15 2018-11-08 取消证书的 SKD 安装或下载功能 添加最新位置(车牌号+车牌颜色)接口 取消排放标准接口 V2.16 2018-12-12 目录 1. 概述.5 2. 适用对象.5 3. 术语和定义.5 4. 接口联调流程.5 4.1. 第一步:获取账密.5 4.2. 第二步:编写接口.6 4.3. 第三步:联调测试.6 5. 技术要求.6 5.1. 接口调用方式.6 5.2. 用户认证.7 6. 接口说明.8 6.1. 位置信息类接口说明.8 6.1.1. 车辆最新位置查询(车牌号)接口.8 6.1.2. 车辆最新位置查询(车牌号+颜色)接口.9 6.1.3. 车辆最新位置查询(vin 车架号)接口.10 6.1.4. 多车最新位置查询.12 6.1.5. 车辆轨迹查询(车牌号)接口.13 6.1.6. 车辆轨迹查询(vin 车架号)接口.18 6.1.7. 车辆签到接口.23 6.2. 信息验证类接口说明.24 6.2.1. 车辆入网验证.24 6.2.2. 车辆确认接口.25 6.2.3. 车主真实性验证接口.26 6.2.4. 套牌车验证.26 6.2.5. 道路运输证验证.27 6.2.6. 车辆行驶证信息查询.28 6.2.7. 道路运输证查询.29 6.3. 车辆事件类接口说明.30 6.3.1. 车辆驶入.30 6.3.2. 车辆驶出.36 6.3.3. 异常离线提醒.43 6.4. 找车发货类接口说明.45 6.4.1. 周边找车接口 V6.0.45 6.4.2. 精准找车接口 V7.0.50 6.4.3. 多维度找车接口.54 6.4.4. 发布货源.58 6.4.5. 发布货源短信.60 6.5. 运营评估类接口说明.61 6.5.1. 企业运力评估.61 6.5.2. 车辆运力评估(车牌号)62 6.5.3. 车辆运力评估(车架号)64 6.5.4. 车辆信息查询(车牌号)65 6.5.5. 车辆信息查询(车架号)67 6.5.6. 车辆运营数据查询.68 6.5.7. 车辆业务数据查询.69 6.6. 统计分析类接口说明.70 6.6.1. 车辆里程查询.70 6.6.2. 车辆停车查询.72 6.6.3. 车辆在途运抵预判.73 6.7. 工具类接口说明.75 6.7.1. 逆地理信息查询.75 7. 常见问题.76 附录 A:状态码说明

78 附录 B:Java 实例代码

79 附录 C:找车接口行政区划编码列表:81

5 1. 概述 智运开放平台整合了道路货运行业内重型载货汽车的全量数据.在基于

500 万+重载 货运车辆的大数据基础上、经过数据清洗、整合、处理后,开放提供多维度、多层次的车 辆数据供用户在道路货运相关业务场景中使用. 智运开放平台 API 服务目前已为物流、金融、交通、保险、政府、车厂六大领域全面 放开数据,开放的接口覆盖:位置信息、找车发货、统计分析、信息验证、事件通知、辅 助工具六大类. 2. 适用对象 本文档适用于期望应用智运数据开放平台做各种数据业务应用的相关工作人员. 3. 术语和定义 ? https HTTPS(全称:Hyper Text Transfer Protocol over Secure Socket Layer) ,是以安全 为目标的 HTTP 通道,简单讲是 HTTP 的安全版.即HTTP 下加入 SSL 层,HTTPS 的安全基础是 SSL,因此加密的详细内容就需要 SSL. 它是一个 URI scheme(抽象标识符体系) ,句法类同 http:体系.用于安全的 HTTP 数据传输. ? crt(证书文件) 客户端通过 https 方式向服务端发出请求时认证的证书、私钥. ? DES 加密 DES 全称为 Data Encryption Standard,即数据加密标准,是一种使用密钥加密的块算 法,1977 年被美国联邦政府的国家标准局确定为联邦资料处理标准(FIPS) ,并授权在非密级 政府通信中使用,随后该算法在国际上广泛流传开来.需要注意的是,在某些文献中,作为算 法的 DES 称为数据加密算法(Data Encryption Algorithm,DEA) ,已与作为标准的 DES 区分开 来. ? SDK(软件开发工具包) 软件开发工具包(外语首字母缩写:SDK、外语全称:Software Development Kit)一般 都是一些软件工程师为特定的软件包、软件框架、硬件平台、操作系统等建立应用软件时的开 发工具的集合. ? 转码 将传输的数据通过 SDK 软件开发工具包进行转码.SDK 软件开发工具包中的转码实现方式 是将数据进行 DES 加密. 4. 接口联调流程 API 接口通过 https 方式对外提供接口服务,向你方开发者提供安全证书,你方在客户端 开发中导入证书,遵循 API 接口规范,发送 https 请求,支持 POST、GET 两种,数据交换接口 将验证 API 用户的合法性和安全性,然后提供接口服务,接口数据采用 UTF-8 格式编码. 4.1. 第一步:获取账密 由你方商务人员向我方商务人员发起申请,申请成功后将为您提供调用接口所需的 API 账6号、密码及客户端 ID 信息. 4.2. 第二步:编写接口 编写调用 API 接口的客户端代码,按照接口定义的 https 调用方式及传输转换后的参数进 行调用,调用示例代码详见附录 B 及调用示例工程. 4.3. 第三步:联调测试 联调测试环境域名为:testopen.95155.com,请根据文档中的示例参数或示例程序进行联 调,联调环境为非正式数据,需使用我方指定的参数进行联调.接口调用成功且返回数据可正 常解析后,表示联调成功. 联调过程中如遇到问题,请与我方售前工程师或运营人员联系,联调通过后如需使用正式 环境则与我方商务人员联系,会为您提供正式环境域名及账号、密码、客户端 ID 等信息. 5. 技术要求 5.1. 接口调用方式 API 接口通过 https 方式对外提供接口服务,向你方开发者提供安全证书,你方在客户端 开发中导入证书,遵循 API 接口规范,发送 https 请求,支持 POST、GET 两种,数据交换接口 将验证 API 用户的合法性和安全性,然后提供接口服务,接口数据采用 UTF-8 格式编码.

7 5.2. 用户认证 将根据第三方开发者访问的车辆范围,进行用户授权等权限验证,保障用户数据的安全 性. 用户首次调用接口,须先登录,认证通过后生成令牌. 令牌有效期为动态,登录后之前的令牌将立即失效,多服务调用业务接口时,建议由统一 服务调用登录接口将令牌缓存起来,多个服务统一从共享缓存中获取令牌.令牌失效后再调用 登录接口统一获取令牌,避免频繁调用登录接口,建议一天内登录次数不超过

10 次,超过

10 次将触发安全系统报警. 示例: 待转码格式 user=您的 API 账号&

pwd=您的密码 请求地址格式 https://testopen.95155.com/apis/login/转码后数据?client_id=您的客户端 ID 接口返回数据解码后样例: { result : 301f4556-f9bd-4e9c-9a3d-c0cd7a6ad7db , status :1001} (注:信息返回格式为转码格式,需解码后才可显示以下数据样例格式)

8 参数 说明 result 令牌 status 登录状态:详见附录 A 6. 接口说明 6.1. 位置信息类接口说明 6.1.1. 车辆最新位置查询(车牌号)接口 描述 本接口提供指定车牌号的车辆最新位置查询. 接口调用示例: 待转码格式 token=您的令牌&

vclN=陕YH0009&

timeNearby=24 请求........