JT_T 1225.2-2018内河船舶能耗在线监测 第2部分：数据交换.pdf

ICS 03.220.40 ;35.240.60JTR 07备案号：中华人民共和国交通运输行业标准JT/T 1225.2—2018内河船舶能耗在线监测第2部分：数据交换Online energy consumption monitoring for inland vessel-Part 2: Data exchange2018-08-29发布2018-12-01实施中华人民共和国交通运输部发布 JT/T 1225.2—2018目次前言围2规范性引用文件3术语和定义、缩略语4数据交换内容5数据交换格式6数据交换频率数据交换方法附录A(规范性附录）Web服务接口API方法 JT/T 1225.2—2018status: 0,Ish:1, fbs:1bxh:1,jilts:2,result: (1: (JGID: X X X 1,JGMC:*X X ×1,JGLXDM: *X × × 1.SIJGID:*× × × 1*2: (JGID: *X × ×2,JGMC:*X × ×2,JGLX: *X X X2,SJGID:*X × ×2,图 A.2静态数据请求API的应答JSON格式数据包示例表A.5动态数据交换API的参数列表参数约束默认值说明及要求otput可选xml 返回的数据格式，值坡为：json-JSON格式;xml-XML格式Ibsh必选无请求的流水号，用于多个请求与返回的对应，1~10000的连续数字date_table_id必选无请求交换的数据表标识cbsbh可选无舶识别号，请求数据时，以舶舶识别号作为查询关键词，如果无该参数，则查询所有船舶tej可选无人库时间，请求数据时，以大于某个人库时间为条件查询，如果无该参数，则入库时间不受限制jls可选无请求交换的记录条数表A.6动态数据交换API的应答数据格式字段类型说明及要求status整型返网调用状态码，值域：0-正常；1-错误 Ih整型返回请求的流水号 JT/T 1225.2—2018表A.6(续)字段类型说明及要求fhs整型分包数，即一次请求的数据可以分多个包发送bah整型分包序号，从1并始 jlts整型该包的记录条数result-本次返回的数据，包含多条记录A.3.3示例动态数据交换API的URL示例如下：*http://api. sjh, xxx. com/dtsj/v1/? output = jsonlsh = 1data_table_id = nhjc_nhcb_denyxhlcbsbh= 1234567890123rksj =2017/8/1 10 : 10 :00jlts =2 在以上URL示例中；/dtsj/v1/为服务地址，服务地址由域名（api.sjih，xxxcom）、服务名（dtsj）、服务版本号（v1）组成；“？后面为请求参数，“为参数分隔符。动态数据交换API的应答JSON格式数据包示例如图A.3所示。该示例返回两条记录。status: 0, Ish:1.[:Sq]bxh:1, jlts:2,result: (1: (CBSBH:*X X X I,HXLC:*X × ×1,NYXHL:*X X X 1,SJZHL: X X X 11.2: (CBSBH: *X X X 2,HXLC:X X X2,NYXHL: X X X 2,SJZHL: X X X 2围A.3动态数据请求的座答JSON格式数据包示例A.4周期汇总数据交换APIA.4.1功能数据请求方向数据提供方发送周期汇总数据请求，数据提供方收到该请求后返回相应的周期汇总9 1 1/1F1225.2—2018数据。A.4.2方法周期汇总数据交换API的参数列表和应答数据格式分别见表A.7和表A.8。表A.7周期汇总数据交换API的参数列表参数约束默认值说明及要求output可选ml编出格式为 json 或者xml Ish必选无请求的流水号，用于多个请求与返国的对应，1~10000的连续整数data_table_id必选无请求交换的数据表标识chsbh可选无骼舶识别号，如果无该参数，则查询所有船舶hzsjldm可选无汇总时间分类代码，如果无该参数，则查询所有汇总周期类型hzpsj可选无汇总起始时间，请求数据时，以某个汇总起始时间为条件查询，如果无该参数，则查御所有汇总起始时间jlts可选无请求交换的记录条数装A.8周期汇总数据交换API的应答数据格式字段类型说明及要求status整型返回调用状态码，值域：0-正常；1-错误整型返国请求的流水号fis整型分包数，即一次请求的数据可以分多个包发送bah整型分包序号，从1开始 jlis整型该包的记录条数result一本次返回的数据，包含多条记录A.4.3示例周期汇总数据交换API的URL示例如下：http://api. sjh. xxx.