ICS03.220CCSR20DB2102大連市市場監(jiān)督管理局發(fā)布1DB2102/T0125—2024本文件按照GB/T1.1-2020《標(biāo)準(zhǔn)化工作導(dǎo)則第1部分：標(biāo)準(zhǔn)化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定起請(qǐng)注意本文件的部分內(nèi)容可能涉及專利。本文件的發(fā)布機(jī)構(gòu)不承擔(dān)識(shí)別專利的責(zé)任。本文件由大連市人民政府口岸辦公室提出并歸口。本文件起草單位：大連口岸物流網(wǎng)股份有限公司。本文件主要起草人：楊惠云、毛鈞、周明華、武琦、劉廣會(huì)、張春玲、李志芳、張邁、鄒德文、季珊珊、馮君、呂艷霞、肖玉、邱云鵬、張晉。本文件發(fā)布實(shí)施后，任何單位和個(gè)人如有問題和意見建議，均可通過來電、來函等方式進(jìn)行反饋，有關(guān)單位將及時(shí)答復(fù)并認(rèn)真處理，根據(jù)實(shí)際情況依法進(jìn)行評(píng)估及復(fù)審。歸口管理部門通訊地址：大連市人民政府口岸辦公室（大連市中山區(qū)港灣街2號(hào)航運(yùn)交易市場5樓聯(lián)系電話文件起草單位通訊地址：大連口岸物流網(wǎng)股份有限公司（大連市中山區(qū)港灣街2號(hào)航運(yùn)交易市場3樓），聯(lián)系電話DB2102/T0125—20241集裝箱閘口電子操作條接口規(guī)范本文件規(guī)定了電子操作條內(nèi)容、交互要求及接口定義。本文件適用于口岸集裝箱場站或碼頭應(yīng)用標(biāo)準(zhǔn)化數(shù)據(jù)流規(guī)范集裝箱提送箱閘口業(yè)務(wù)。2規(guī)范性引用文件本文件沒有規(guī)范性引用文件。3術(shù)語和定義3.1集裝箱閘口containergate是進(jìn)出口集裝箱和各種運(yùn)輸機(jī)械的出入口，是區(qū)分碼頭內(nèi)外責(zé)任和交接相關(guān)資料的地點(diǎn)。3.2電子操作條electronicoperationstrip借助即時(shí)通訊工具指導(dǎo)進(jìn)出碼頭或場站的集裝箱卡車進(jìn)行業(yè)務(wù)操作的電子小票。4縮略語下列縮略語適用于本文件。UTF-8：是一種針對(duì)Unicode的可變長度字符編碼（UnicodeTransformationFormat8-bit）HTTP：超文本傳輸協(xié)議（HyperTextTransferProtocol）JSON：一種輕量級(jí)的數(shù)據(jù)交換格式（JavaScriptObjectNotation）MD5：信息學(xué)中使用廣泛的哈希算法（Message-DigestAlgorithm5）RSA：是一種非對(duì)稱加密算法（RonRivest、AdiShamir和LeonardAdleman三人姓氏開頭字母組成）5電子操作條內(nèi)容5.1模板消息模板消息是電子操作的關(guān)鍵內(nèi)容，正常情況下司機(jī)可以根據(jù)模板消息進(jìn)行作業(yè)，不需要進(jìn)入詳情頁面查看完整信息，模板消息由業(yè)務(wù)類型、車牌號(hào)、箱號(hào)及場位數(shù)據(jù)項(xiàng)組成，見表1。約束條件：數(shù)據(jù)項(xiàng)標(biāo)記中，M表示必選項(xiàng)，C表示可選項(xiàng)。DB2102/T0125—20242表1推送模板消息數(shù)據(jù)項(xiàng)1M2M3C4C5.2詳情頁面信息詳情頁面顯示電子操作條的完成內(nèi)容，異常情況司機(jī)需要進(jìn)入詳情頁面查看詳細(xì)信息，詳情頁面信息由車信息、箱號(hào)、場區(qū)場位、錯(cuò)誤信息、注意事項(xiàng)、殘損信息、打印通道、地磅重量、操作人、操作時(shí)間等數(shù)據(jù)項(xiàng)組成，見表2。約束條件：數(shù)據(jù)項(xiàng)標(biāo)記中，M表示必選項(xiàng)，C表示可選項(xiàng)。表2詳情頁面信息數(shù)據(jù)項(xiàng)1M2C3C4C5C6C7M8C9MM6交互要求6.1交互協(xié)議6.1.1采用HTTP協(xié)議作為交互協(xié)議，且采用同步接口方式，即調(diào)用和反饋在一次接口交互中完成。6.1.2文本編碼均采用UTF-8編碼，以防止中文字符亂碼，保證解析處理準(zhǔn)確。6.1.3調(diào)用方請(qǐng)求使用HTTP的post類型的請(qǐng)求方式。6.1.4調(diào)用方的請(qǐng)求參數(shù)及應(yīng)答方的反饋數(shù)據(jù)均使用JSON類型的數(shù)據(jù)格式。6.1.5各數(shù)據(jù)項(xiàng)的具體值類型均為文本類型，在程序中其他類型的數(shù)值可由交互雙方協(xié)定為固定格式的文字表示。6.2加簽算法6.2.1加簽功能是調(diào)用方獲取invokerid及用于加密操作的公鑰，使用MD5算法及RSA算法。6.2.2由雙方協(xié)定用于進(jìn)行加簽操作的原始明文生成規(guī)則，按照原始明文生成規(guī)則生成明文。6.2.3獲得原始明文后，首先使用MD5算法對(duì)原始明文數(shù)據(jù)進(jìn)行處理，獲得原始明文的MD5值，對(duì)此MD5值使用RSA算法及公鑰進(jìn)行加密操作，獲得密文。DB2102/T0125—202436.2.4將invokerid與密文使用“-”（英文中劃線字符）進(jìn)行連接，即獲得格式為“invokerid-密文”6.2.5簽名數(shù)據(jù)在接口調(diào)用時(shí)，將獲得的簽名數(shù)據(jù)作為除正常接口調(diào)用參數(shù)外的附加參數(shù)進(jìn)行接口調(diào)用操作，參數(shù)名固定為“signature”。7接口定義7.1電子操作條接口功能描述：接收碼頭及場站電子操作條數(shù)據(jù)。請(qǐng)求參數(shù)見表3。表3電子操作條接口請(qǐng)求參數(shù)1212workType345如A22施工請(qǐng)繞行?67workArea891workType234567DB2102/T0125—20244表3（續(xù)）879workArea127.2車輛停牌接口功能描述：接收?qǐng)稣净虼a頭車輛停牌數(shù)據(jù)，即把場站或碼頭限制車輛作業(yè)的信息通知給司機(jī)。請(qǐng)求參數(shù)見表4。表4車輛停牌接口請(qǐng)求參數(shù)12123456789DB2102/T0125—20245表4（續(xù)）127.3虛擬提箱接口功能描述：調(diào)用虛擬提箱接口，根據(jù)優(yōu)先提箱作業(yè)區(qū)虛擬提箱并推送提箱操作條信息。請(qǐng)求參數(shù)見表5。表5虛擬提箱接口請(qǐng)求參數(shù)12workArea7.4異常車輛重新入港接口功能描述：調(diào)用車輛重新入港操作，并推送