ICS03.220.40:35.240.60中華人民共和國交通運(yùn)輸行業(yè)標(biāo)準(zhǔn)JT/T1225.2—2018Part2:Dataexchange2018-08-29發(fā)布2018-12-01實(shí)施IJT/T1225.2—2018 1 26數(shù)據(jù)交換頻率 5 5附錄A(規(guī)范性附錄)Web服務(wù)接口API方法 6ⅢJT/T1225.2—2018 本部分為JT/T1225的第2部分。本部分按照GB/T1.1—2009給出的規(guī)則起草。1JT/T1225.2—2018JT/T697.1—2013交通信息基礎(chǔ)數(shù)據(jù)元第1部分：總則JT/T697.1—2013界定的以及下列術(shù)語和定義適用于本文件。3.1.13.1.2干不同數(shù)據(jù)表，數(shù)據(jù)交換內(nèi)容見表1。每張數(shù)據(jù)表由多個(gè)字段構(gòu)成，字段的數(shù)據(jù)類型和數(shù)據(jù)格式遵循JT/T697.1—2013的規(guī)定。2JT/T1225.2—2018序號(hào)信息分類數(shù)據(jù)表名稱數(shù)據(jù)表標(biāo)識(shí)1靜態(tài)機(jī)構(gòu)信息nhjcnhcbjgxx臺(tái))所擁有的行業(yè)管理部門、船舶經(jīng)營業(yè)戶等的2船舶信息nhjcnhcbcbxx每條船舶的基本信息3動(dòng)態(tài)單船能源消耗量nhjcnhcbdenyxhl定時(shí)采集的每條船舶的能源消耗量信息4單船航次nhjcnhcbdche每條船舶的航次信息5單船能源消耗量匯總匯總數(shù)據(jù)機(jī)構(gòu)信息數(shù)據(jù)交換格式見表2。序號(hào)字段名稱字段標(biāo)識(shí)數(shù)據(jù)類型數(shù)據(jù)格式說明及要求1機(jī)構(gòu)統(tǒng)一社會(huì)信用代碼JGTYSHXYDM字符型n18見GB32100—20152機(jī)構(gòu)名稱JGMC字符型an..100企業(yè)、事業(yè)單位、機(jī)關(guān)、社會(huì)團(tuán)體及其他依法成立的單位的名稱3上級(jí)機(jī)構(gòu)統(tǒng)一社會(huì)信用代碼SUGTYSHXYDM字符型n18上級(jí)機(jī)構(gòu)的統(tǒng)一社會(huì)信用代碼；如無上級(jí)機(jī)構(gòu)則為空序號(hào)字段名稱字段標(biāo)識(shí)數(shù)據(jù)類型數(shù)據(jù)格式說明及要求1船舶識(shí)別號(hào)CBSBH字符型anl3見JT/T697.5—2013中12船舶登記號(hào)CBDJH字符型anl6見JT/T697.5—2013中3中文船名ZWCM字符型an..100見JT/T697.5—2013中4船籍港代碼CJGDM字符型見JT/T697.5—2013中5船籍港名稱CJGMC字符型an..50見JT/T697.5—2013中06初次登記號(hào)CCDJH字符型anl6見JT/T697.5—2013中27船舶種類代碼CBZLDM字符型n..4見JT/T697.5-2013中33JT/T1225.2—2018表3(續(xù))序號(hào)字段名稱字段標(biāo)識(shí)數(shù)據(jù)類型數(shù)據(jù)格式說明及要求8主機(jī)功率ZJGL數(shù)字型n8.2見JT/T697.5—2013中59箱位數(shù)字型n..5見JT/T697.5—2013中8客位KW數(shù)字型n..5見JT/T697.5—2013中9車位數(shù)字型n..5見JT/T697.5—2013中0船舶營業(yè)運(yùn)輸證編號(hào)CBYYYSZBH字符型an30根據(jù)船舶營業(yè)運(yùn)輸證填寫船舶營業(yè)運(yùn)輸證簽發(fā)機(jī)構(gòu)IDCBYYYSZOFJGID字符型n18采用統(tǒng)一社會(huì)信用代碼船舶日常管理機(jī)構(gòu)IDCBRCGLJGID字符型n18采用統(tǒng)一社會(huì)信用代碼經(jīng)營業(yè)戶名稱JYYHMC字符型an..100指擁有該船舶經(jīng)營權(quán)的企業(yè)或個(gè)體經(jīng)營戶的名稱，根據(jù)船舶營業(yè)運(yùn)輸證中的船舶經(jīng)營人填寫經(jīng)營業(yè)戶機(jī)構(gòu)IDJYYHJGID字符型n18采用統(tǒng)一社會(huì)信用代碼經(jīng)營業(yè)戶類型JYYHLX字符型指船舶經(jīng)營業(yè)戶的經(jīng)濟(jì)類型值域：1-企業(yè)；2-個(gè)體額定載貨量EDZHL數(shù)字型n..3根據(jù)船舶營業(yè)運(yùn)輸證中的載貨定額填寫，單位：噸(t)序號(hào)字段名稱字段標(biāo)識(shí)數(shù)據(jù)類型數(shù)據(jù)格式說明及要求1船舶識(shí)別號(hào)CBSBH字符型見JT/T697.5—2013中12航行里程HXLC數(shù)字型n..10,2單位：km3能源消耗量NYXHL數(shù)字型n..10,2內(nèi)河船舶能耗在線監(jiān)測(cè)數(shù)據(jù)采集設(shè)備(以下簡稱數(shù)據(jù)采集設(shè)備)上傳的累計(jì)能源消耗量，單位：升(L)4實(shí)際載貨量數(shù)字型n..10,2數(shù)據(jù)采集設(shè)備上傳的當(dāng)前實(shí)際載貨量，單位：噸(t)單船航次數(shù)據(jù)交換格式見表5。4JT/T1225.2—2018序號(hào)字段名稱字段標(biāo)識(shí)數(shù)據(jù)類型數(shù)據(jù)格式說明及要求1船舶識(shí)別號(hào)CBSBH字符型an13見JT/T697.5—2013中12航次序號(hào)HCXH字符型n..10唯一標(biāo)識(shí)單船航次的序號(hào)，按照航次發(fā)生時(shí)間的順序以步長1遞增3航次開始時(shí)間HCKSSJ日期時(shí)間型YYYYMMDDhhmmss上個(gè)航次貨物卸空的日期4航次結(jié)束時(shí)間HCJSSJ日期時(shí)間型YYYYMMDDhhmmss本航次貨物卸空的日期5航次起點(diǎn)港口名稱HCQDGKMC字符型an..100上個(gè)航次貨物卸空的港口名稱6航次終點(diǎn)港口名稱HCZDGKMC字符型an..100本航次貨物卸空的港口名稱7總航行里程ZHXLC數(shù)字型an..8,2本航次的標(biāo)準(zhǔn)航線里程如在航次中途經(jīng)多個(gè)港口，則需要根據(jù)船舶航行路線的順序，將途經(jīng)的各港口間標(biāo)準(zhǔn)航線里程進(jìn)行加總，單位：公里(km)8重載航行里程ZZHXLC數(shù)字型an..8.2一個(gè)完整航次中發(fā)生貨物運(yùn)輸?shù)臉?biāo)準(zhǔn)航線里程，即從開始裝貨地點(diǎn)到航次終點(diǎn)的航行里程，單位：公里9貨運(yùn)量HUOYL數(shù)字型an..20.4運(yùn)載貨物重量，單位：噸(t)貨物周轉(zhuǎn)量HWZZL數(shù)字型an..8,2一個(gè)航次內(nèi)實(shí)際運(yùn)送的每批貨物與其相應(yīng)航行里程的乘積之和，單位：噸公里(t·km)集裝箱運(yùn)量JZXXL數(shù)字型an..8.2指船舶運(yùn)輸集裝箱折合20ft(1ft=0.3048m)標(biāo)準(zhǔn)箱的數(shù)值，若船舶種類為集裝箱船時(shí)，該字段應(yīng)不為空。單位：標(biāo)準(zhǔn)箱(TEU)集裝箱周轉(zhuǎn)量JZXZZL數(shù)字型an..8,2指船舶運(yùn)輸集裝箱折合20ft標(biāo)準(zhǔn)箱時(shí)的周轉(zhuǎn)量，船舶種類為集裝箱船時(shí)，該字段應(yīng)不為空，單位：標(biāo)準(zhǔn)箱公里(TEU·km)5JT/T1225.2—2018序號(hào)字段名稱字段標(biāo)識(shí)數(shù)據(jù)類型數(shù)據(jù)格式說明及要求1船舶識(shí)別號(hào)CBSBH字符型anl3見JT/T697.5—2013中12匯總時(shí)間分類代碼HZSJFLDM字符型值域：1-按年度匯總；2-按季度匯總；3-按月匯總；4-按日匯總3開始時(shí)間KSSJ日期時(shí)間型YYYYMMDDhhmmss匯總的開始時(shí)間4結(jié)束時(shí)間JSSJ日期時(shí)間型YYYYMMDDhhmmss匯總的結(jié)束時(shí)間5完成航次數(shù)WCHCS數(shù)字型n..5匯總期內(nèi)完成的航次數(shù)6總行程ZXC數(shù)字型n..18,3單位：公里(km)7載運(yùn)行程ZYXC數(shù)字型n..18,3單位：公里(km)8貨運(yùn)量HUOYL數(shù)字型n..18,3單位：噸(t)9貨物周轉(zhuǎn)量HWZZL數(shù)字型n..18,3單位：噸公里(t·km)千噸公里能源消耗QDGLNYXH數(shù)字型n..18,3單位：升每千噸公里[L/(kt·km)]6.1靜態(tài)數(shù)據(jù)6.3周期匯總數(shù)據(jù)周期匯總數(shù)據(jù)應(yīng)按照匯總周期進(jìn)行交換6JT/T1225.2—2018Web服務(wù)接口API方法A.1總體要求數(shù)據(jù)交換的通信數(shù)據(jù)應(yīng)采用UTF-8編碼。服務(wù)API接口的調(diào)用應(yīng)有安全認(rèn)證機(jī)制，以防范未授權(quán)A.2靜態(tài)數(shù)據(jù)交換APIA.2.1靜態(tài)數(shù)據(jù)變化通知APIA.2.1.1功能A.2.1.2方法靜態(tài)數(shù)據(jù)變化通知API的參數(shù)列表和應(yīng)答數(shù)據(jù)格式分別見表A.1和表A.2。參數(shù)約束默認(rèn)值說明及要求output可選返回的數(shù)據(jù)格式，值域?yàn)椋簀son-JSON格式；xml-XML格式必選無通知的流水號(hào)，用于多個(gè)通知與返回的對(duì)應(yīng)，1～10000的連續(xù)數(shù)字必選無發(fā)生變化的數(shù)據(jù)表標(biāo)識(shí)字段類型說明及要求status整型返回的狀態(tài)碼，值域：0-正常；1-錯(cuò)誤整型返回相應(yīng)的通知流水號(hào)A.2.1.3示例“/jtsjbh/v1/?output=json&lsh=1&data_table_id=nhjc_nhcb_jgxx”。status:0,圖A.1靜態(tài)數(shù)據(jù)變化通知API的應(yīng)答JSON格式數(shù)據(jù)包示例7JT/T1225.2—2018A.2.2.1功能A.2.2.2方法靜態(tài)數(shù)據(jù)請(qǐng)求API的參數(shù)列表和應(yīng)答數(shù)據(jù)格式分別見表A.3和表A.4。表A.3靜態(tài)數(shù)據(jù)請(qǐng)求API的參數(shù)列表參數(shù)約束默認(rèn)值說明及要求output可選返回的數(shù)據(jù)格式，值域?yàn)椋簀son-JSON格式；xml-XML格式必選無請(qǐng)求的流水號(hào)，用于多個(gè)請(qǐng)求與返回的對(duì)應(yīng)，從1～10000的連續(xù)數(shù)字必選無請(qǐng)求的數(shù)據(jù)表IDrange可選請(qǐng)求的數(shù)據(jù)范圍，值域：all-返回整個(gè)數(shù)據(jù)表；change-只返回發(fā)生變化的部分字段類型說明及要求整型返回調(diào)用狀態(tài)碼，值域：0-正常；1-錯(cuò)誤整型返回相應(yīng)的請(qǐng)求流水號(hào)整型分包數(shù)，即一次請(qǐng)求的數(shù)據(jù)可以分多個(gè)包發(fā)送bxh整型分包序號(hào)，從1開始整型本次返回的記錄條數(shù)result 本次返回的數(shù)據(jù)，包含多條記錄A.2.2.3示例“/jtsj/vl/?output=json&lsh=1&data_table_id=nhjc_nhcb_jgxx&range=change”。靜態(tài)數(shù)據(jù)請(qǐng)求API的應(yīng)答JSON格式數(shù)據(jù)包示例如圖A.2所示。該示例返回兩條發(fā)生變化的A.3動(dòng)態(tài)數(shù)據(jù)交換APIA.3.1功能動(dòng)態(tài)數(shù)據(jù)交換API的參數(shù)列表和應(yīng)答數(shù)據(jù)格式分別見表A.5和表A.6。8JT/T1225.2—2018status:0,fbs:1bxh:1,jlts:2,result:{JGID:“×××1”,JGMC:“XX×1”JGLXDM:“×××1”,SUIGID:“×××1”JGID:“X×X2”JGMC:“×××2”,JGLX:“×××2”,SJJGID:“×××2”,表A.5動(dòng)態(tài)數(shù)據(jù)交換API的參數(shù)列表參數(shù)約束默認(rèn)值說明及要求可選返回的數(shù)據(jù)格式，值域?yàn)椋簀son-JSON格式；xml-XML格式必選無請(qǐng)求的流水號(hào)，用于多個(gè)請(qǐng)求與返回的對(duì)應(yīng)，1～10000的連續(xù)數(shù)字必選無請(qǐng)求交換的數(shù)據(jù)表標(biāo)識(shí)可選無船舶識(shí)別號(hào)，請(qǐng)求數(shù)據(jù)時(shí)，以船舶識(shí)別號(hào)作為查詢關(guān)鍵詞，如果無該參數(shù)，則查詢所有船舶可選無入庫時(shí)間，請(qǐng)求數(shù)據(jù)時(shí)，以大于某個(gè)入庫時(shí)間為條件查詢，如果無該參數(shù)，則入庫時(shí)間不受限制可選無請(qǐng)求交換的記錄條數(shù)表A.6動(dòng)態(tài)數(shù)據(jù)交換API的應(yīng)答數(shù)據(jù)格式字段類型說明及要求status整型返回調(diào)用狀態(tài)碼，值域：0-正常：1-錯(cuò)誤整型返回請(qǐng)求的流水號(hào)9JT/T1225.2—2018表A.6(續(xù))字段類型說明及要求整型分包數(shù)，即一次請(qǐng)求的數(shù)據(jù)可以分多個(gè)包發(fā)送bxh整型分包序號(hào)，從1開始整型該包的記錄條數(shù)result—本次返回的數(shù)據(jù)，包含多條記錄“/dtsj/v1/?output=json&lsh=1&data_table_id=nhjc_nhcb_dcnyxhl&cbsbh=1234567890123&rksj=2017/8/110:10:00&jlts=2”。status:0,lsh:1.fbs:1bxh:1,jlts:2,result:{CBSBH:“X××1”HXLC:“×××1”,NYXHL:“×××1”,SJZHL:“×××1”CBSBH:“XX×2”HXIC:“X××2”.NYXHL:“×××2”,SJZHL:“×××2”}A.4周期匯總數(shù)據(jù)交換APIA.4.1功能JT/T1225.2—2018A.4.2方法周期匯總數(shù)據(jù)交換API的參數(shù)列表和應(yīng)答數(shù)據(jù)格式分別見表A.7和表A.8。表A.7周期匯總數(shù)據(jù)交換API的參數(shù)列表參數(shù)約束默認(rèn)值說明及要求output可選xml輸出格式為json或者xml必選無請(qǐng)求的流水號(hào)，用于多個(gè)請(qǐng)求與返回的對(duì)應(yīng)，1～10000的連續(xù)整數(shù)必選無請(qǐng)求交換的數(shù)據(jù)表標(biāo)識(shí)cbsbh可選無船舶識(shí)別號(hào)，如果無該參數(shù)，則查詢所有船舶hzsjfldm可選無匯總時(shí)間分類代碼，如果無該參數(shù)，則查詢所有匯總周期類型hzqssj可選無匯總起始時(shí)間，請(qǐng)求數(shù)據(jù)時(shí)，以某個(gè)匯總起始時(shí)間為條件查詢，如果無該參數(shù)，則查詢所有匯總起始時(shí)間可選無請(qǐng)求交換的記錄條數(shù)表A.8周期匯總數(shù)據(jù)交換API的應(yīng)答數(shù)據(jù)格式字段類型說明及要求status整型返回調(diào)用狀態(tài)碼，值域：0-正常；1-錯(cuò)誤整型返回請(qǐng)求的流水號(hào)整型分包數(shù)，即一次請(qǐng)求的數(shù)據(jù)可以分多個(gè)包發(fā)送bxh整型分包序號(hào)，從1開始整型該包的記錄條數(shù)result—本次返回的數(shù)據(jù)，包含多條記錄A.4.3示例“/zqhzsj/vl/?output=json&lsh=1&data_table_id=nhjc_nhcb_denyxhlhz&cbsbh=1234567890123&hzsjfldm=3&hzqssj=2017/8/100:00:00&jlts=2”。JT/T1225.2—2018{bxh:1,result:{CBSBH: