《民航旅客遺失物品統(tǒng)一查詢平臺技術標準》

T/CCAATB0003—2020目次TOC\o"1-3"\h\u22281前言 37922引言 418871全國旅客遺失物品統(tǒng)一查詢平臺技術標準 575121本標準適用范圍 5215912規(guī)范性引用文件 5206473術語和定義 548634平臺通用前端投產使用規(guī)范 552604.1網絡聯(lián)調 5109674.2服務對接 5309984.3基礎數據建立 6299914.4文件上傳 6158664.5信息安全 661715平臺標準化接口對接規(guī)范 7268405.1網絡聯(lián)調 788175.2服務對接 7221875.3基礎數據建立 7106535.4業(yè)務數據維護 7270935.5信息安全 797835.6接口服務 8前言本標準按照GB/T1.1-2020《標準化工作導則第1部分：標準化文件的結構和起草規(guī)則》給出的規(guī)則起草。本標準由中國民用機場協(xié)會提出并解釋。本標準起草單位：中國民航信息集團有限公司、東北民航凱亞有限公司。本標準主要起草人：杜曉銘，許軼琳，郭紅霞，劉謙，楊棟，王欣，浦黎，張婧，程忠鋒，陳新，鄢潔。引言目前，民航領域的機場、航空公司客流持續(xù)大規(guī)模增長，服務場景飽和度增大，旅客失物的總量隨場景服務旅客的龐大基數不斷增加。鑒于現(xiàn)階段全國各機場、各航空公司失物招領業(yè)務多為線下運行模式，被動的接收失物信息，并由工作人員人工錄入（記錄），分類保管，等待失主聯(lián)系確認，最終完成失物找回的流程。受服務區(qū)域、旅客對服務單位的了解的局限性影響，及各平臺間信息互通不暢，服務半徑較小、找回方式過于傳統(tǒng)。造成旅客找回失物的難度大、效率低。各機場、航司雖根據各自不同流程，做了大量工作，但據不完全統(tǒng)計，整體平均找回率仍保持在10%以下。民航類遺失物品業(yè)務，并不適應現(xiàn)有社會網絡技術條件下旅客的線上行為習慣，大大影響旅客對民航服務質量的總體感受。因此，在民航全行業(yè)建立一個信息在線匯集、數據共享、在線公示并支持失主登記及代寄領取的線上平臺，實現(xiàn)機場、航空公司、失主三者間的信息共享互通。通過線上模式優(yōu)化失物招領流程，拓寬失物招領平臺服務半徑，最大程度解決因信息閉塞造成的人力資源及物品資源消耗，提升旅客失物找尋效率及民航服務質量，已成為行業(yè)的必要之舉，也是全行業(yè)的一致共識。為能夠使該系統(tǒng)更好的為行業(yè)服務、為旅客服務，特根據《全國旅客遺失物品統(tǒng)一查詢平臺》開發(fā)實現(xiàn)的相關內容，并參考《民用機場遺失物品管理》（CCAATB-0011-2021）制定技術標準。為行業(yè)使用該平臺，提供必要參考和相關約定。全國旅客遺失物品統(tǒng)一查詢平臺技術標準本標準適用范圍民用機場（以下簡稱機場）遺失物品業(yè)務平臺化建設及平臺對接的規(guī)范和約定，并為全國機場的遺失物品信息化管理提供參考。本標準適用對象:尚未建設遺失物品信息化管理平臺的機場，通過使用《全國旅客遺失物品統(tǒng)一查詢平臺》（以下簡稱平臺）的前端對遺失物品進行信息化管理，以及平臺投產使用規(guī)范；已建設遺失物品信息化管理平臺的機場，可遵照《全國旅客遺失物品統(tǒng)一查詢平臺》標準化接口,通過接口對接的方式與《全國旅客遺失物品統(tǒng)一查詢平臺》進行數據對接。規(guī)范性引用文件下文中的內容通過規(guī)范性引用而構成本標準必不可少的條款。其中，注日期的引用文件，僅注日期的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件?！睹裼脵C場遺失物品管理》（CCAATB-0011-2021）術語和定義本文件沒有需要界定的術語和定義。平臺通用前端投產使用規(guī)范網絡聯(lián)調機場應向平臺提交所有失物招領服務柜臺的外網出口IP段。平臺應根據機場方提交的出口IP段開通網絡策略。機場應對平臺開通的網絡策略情況進行網絡驗證。服務對接機場應參與全國民航遺失物品統(tǒng)一查詢平臺通用前端的投產培訓，掌握平臺通用前端的操作方法、使用流程及注意事項。機場應向平臺申請通用前端的管理賬號及密碼,并對賬號及密碼進行合法驗證并妥善保管。機場應確保業(yè)務辦理流程規(guī)范化，嚴格按照《民用機場遺失物品管理》（CCAATB-0011-2021）辦理遺失物品業(yè)務，保證平臺數據準確性?；A數據建立機場應向平臺提供機場三字碼、機場名稱、機場英文名/拼音、經度與緯度、機場失物招領處服務電話、機場航站樓及失物招領處位置等相關信息。當以上信息變更時，應及時進行維護。全國遺失物品統(tǒng)一查詢平臺通用前端的機場管理員應根據本機場遺失物品崗位職責為平臺通用前端創(chuàng)建角色。全國遺失物品統(tǒng)一查詢平臺通用前端的機場管理員，應為本機場遺失物品工作人員開通平臺通用前端的業(yè)務設置賬號，根據崗位職責授予相關角色。文件上傳遺失物品撿拾登記、失主認領、過期處理等業(yè)務辦理時，需要上傳物品圖片、交接單等相關信息，上傳文件應滿足如下規(guī)則：遺失物品登記時，上傳物品圖片應清晰準確，圖片格式為JPG、JPEG、PNG。遺失物品登記完成時，上傳的《旅客遺失物品登記表》簽字清晰、無涂抹，文件上傳格式為JPG、JPEG、PNG。認領遺失物品時，上傳的《遺失物品認領表》簽字清晰、無涂抹，文件上傳格式為JPG、JPEG、PNG。過期遺失物品處置后，上傳的《過期物品清單》簽字清晰、無涂抹，文件上傳格式為JPG、JPEG、PNG。信息安全機場辦理的遺失物品數據各業(yè)務節(jié)點狀態(tài)及遺失物品信息變更后，應將數據及時維護到《全國旅客遺失物品統(tǒng)一查詢平臺》，確保平臺數據準確性?！度珖每瓦z失物品統(tǒng)一查詢平臺》用戶，僅限使用GoogleChrome、Firefox、360極速版三種瀏覽器。平臺限制對接單位要提前申請開通IP出口白名單，僅允許有效用戶訪問。平臺通用前端賬號密碼應由數字、字符、特殊字符組合，要求8位以上，并要求用戶定期更換。如出現(xiàn)密碼丟失，應由該機場管理員重置密碼恢復使用。平臺符合等保2.0要求。密碼連續(xù)輸入錯誤5次即被系統(tǒng)鎖定，需由該機場管理員向平臺申請解鎖，恢復使用。平臺賬號密碼登錄過程，采用特殊加密解密方法傳輸，防止竊取，保障安全。平臺賬號登錄后，30分鐘內無業(yè)務操作，系統(tǒng)自動將該賬號登出，重新登錄恢復使用。平臺為每個機場僅發(fā)放一個管理員賬號，其他子賬號由機場管理員賬號自行創(chuàng)建（平臺自動進行賬號規(guī)范性校驗，避免賬號重復），并負責所有賬號安全管理。機場終端要求：全部使用正版軟件，開啟殺毒軟件及監(jiān)控。其他關于網絡安全、系統(tǒng)安全限制，請遵照機場相關安全保障規(guī)定進行設置。平臺涉及的旅客數據，遵照《中華人民共和國網絡安全法》的相關規(guī)定妥善保管，不得作為平臺外其他應用，出現(xiàn)違反相關規(guī)定及法規(guī)的情況，應由責任人承擔一切后果。平臺標準化接口對接規(guī)范網絡聯(lián)調機場應向平臺提交所有失物招領服務柜臺的外網出口IP段。平臺應根據機場方提交的出口IP段開通網絡策略。機場應對平臺開通的網絡策略情況進行網絡驗證。服務對接機場應根據平臺提供的《民航旅客遺失物品統(tǒng)一查詢平臺》標準化對接接口文檔，籌備對接研發(fā)工作；機場應向平臺申請安全對接賬號與密碼,并對賬號及密碼進行合法驗證并妥善保管；機場應與平臺標準化接口聯(lián)調測試，運用標準化接口數據要求，確認對接準確無誤；機場應保證通過標準化接口傳輸的遺失物品信息符合平臺標準；基礎數據建立機場應向平臺提供機場三字碼、機場名稱、機場英文名/拼音、經度與緯度、機場失物招領處服務電話、機場航站樓及失物招領處位置等相關信息。當以上信息變更時，應及時進行維護。業(yè)務數據維護機場應對對接數據進行實時監(jiān)測，確保對接數據的準確性、完整性。信息安全機場辦理的遺失物品數據各業(yè)務節(jié)點狀態(tài)及遺失物品信息變更后，應及時與平臺聯(lián)系修改，確保平臺數據準確性。平臺限制對接單位要提前申請開通IP出口白名單，僅允許有效用戶訪問。平臺賬號密碼應由數字、字符、特殊字符組合，要求8位以上，并要求用戶定期更換。調用平臺標準化接口過程，采用特殊加密解密方法傳輸，防止竊取，保障安全。機場接口應用服務器，使用正版操作軟件及數據庫，開啟安全監(jiān)控。其他關于網絡安全、系統(tǒng)安全限制，請遵照機場相關安全保障規(guī)定進行設置。平臺涉及的旅客數據，遵照《中華人民共和國網絡安全法》的相關規(guī)定妥善保管，不得作為平臺外其他應用，出現(xiàn)違反相關規(guī)定及法規(guī)的情況，應由責任人承擔一切后果。接口服務適用范圍：使用《全國旅客遺失物品統(tǒng)一查詢平臺》接口對接的機場及其他被授權方。通信約定接口訪問關系《全國旅客遺失物品統(tǒng)一查詢平臺》接口均作為請求接收方，機場或協(xié)會為請求發(fā)起方。（見REF_Ref27072\h圖1）圖SEQ圖\*ARABIC1通信協(xié)議失物招領平臺與各機場之間采用HTTPS協(xié)議進行數據傳輸和通信。通信雙方采用一問一答的通訊機制，即一次請求對應于一次應答。一般情況，通信雙方之間的消息發(fā)送后等待T秒后未收到響應，應立即重發(fā)，再連續(xù)發(fā)送N-1次后仍未得到響應則停發(fā)。每1秒內只允許發(fā)送一次請求?，F(xiàn)階段建議取值為：T=30秒，N=5。數據一致性為了達到數據一致性，各機場平臺數據變更需及時調用接口達到雙方平臺數據實時同步。必填字段不能提供則自行填充一個合理的默認值，字段映射不能完全關聯(lián)，建議機場方做字段映射匹配，如失物類型匹配。接口結構輸入參數將所有輸入參數封裝為各種類型的輸入參數請求事件對象傳遞。輸入參數請求事件對象中有允空輸入參數，可以不必賦值，直接保持為空即可。輸入參數請求事件對象中有2選1的輸入參數，只需要輸入其中一個，另外一個輸入參數不必賦值，直接保持為空即可。返回參數返回結果全部以各種類型的操作結果響應對象方式返回，返回內容至少包含本次操作的返回結果碼。統(tǒng)一約定code為0表示此次接口調用成功。操作結果響應data對象需要返回的其他信息由各個接口具體功能決定。（見REF表1\h表1）參數名類型是否必需codeString是msgString是dataJSON是表SEQ表\*ARABIC1注：查詢接口不提供參數校驗，如果查詢條件不能滿足，返回0條記錄；例如查詢一個不存在的失物列表信息，不會返回錯誤碼-1，而是直接返回記錄數0。編碼格式失物招領系統(tǒng)平臺所有接口調用參數、返回值中的字符串均采用utf-8編碼。平臺提供標準接口獲取accessToken接口根據接收參數，返回用戶身份碼accessToken；此接口為識別用戶身份信息核心接口；機場請求業(yè)務接口前，優(yōu)先請求調用accessToken接口，獲取accessToken身份識別碼，保證安全訪問控制，機場請求accessToken接口所需userName與clientId需要向軟件提供方申請。輸入參數Header見REF_Ref25077\h表2。參數名類型是否必需描述requestIdString是UUIDAuthorizationString是加密的(userName+clientId)userName與clientId線下向軟件提供方申請clientIdString是平臺分配的客戶IdContent-TypeString是固定寫法，內容如下application/x-www-form-urlencoded表SEQ表\*ARABIC2輸出參數輸出參數見REF_Ref25116\h表3。參數名類型是否必需描述codeString是錯誤代碼msgString是錯誤信息dataJSON對象是返回結果對象>access_tokenString否獲取到的access_token,存放在之后接口的header中>token_typeString否Token類型>expires_inString否過期時間，單位s>scopeString否Token域表SEQ表\*ARABIC3輸出示例如下：{"code":"0","msg":"success","data":{"access_token":"fc7ae635-4477-4f43-b5f1-84810af76466","token_type":"bearer","expires_in":3599,"scope":"all"}}查詢遺失物品接口根據接收參數，查詢對應條件下的被機場公示出來的遺失物品信息，分頁顯示。請求類型請求類型見REF_Ref25272\h表4。請求類型備注POST查詢公示物品列表表SEQ表\*ARABIC4輸入參數Header見REF_Ref25380\h表5。參數名類型是否必需描述requestIdString是UUIDAuthorizationString是"Bearer"+access_Token（BearerToken方式的認證信息）clientIdString是線下分配客戶IdContent-TypeString是固定寫法，內容如下：application/json;charset=utf-8表SEQ表\*ARABIC5Param見REF_Ref25439\h表6。參數名類型是否必需描述參數類型pickupBeginTimeString否查詢條件-撿拾日期開始時間，有則查，格式：yyyy-MM-ddRequestBodypickupEndTimeString否查詢條件-撿拾日期結束時間，有則查RequestBodyairportCodeString否查詢條件-機場三字碼，有則查RequestBodyconfigCodeString否查詢條件-類型的配置編碼(分類信息中的分類ID)，有則查，configCode編碼規(guī)則見附件RequestBodyisPublicityInteger否查詢條件-公示狀態(tài)，有則查；0為是，1為否RequestBodylostPropertyStatusInteger否查詢物品狀態(tài)RequestBodysearchBarString否查詢條件-搜索框，（編號、名稱）有則查RequestBodyairportKeystring否機場秘鑰RequestBodypageNumInteger是當前頁（默認為1）RequestParampageSizeInteger是每頁數（默認20，最大支持50）RequestParam表SEQ表\*ARABIC6輸入示例{"searchBar":"雨傘"}輸出參數輸出參數見REF_Ref25619\h表7。參數名類型是否必需描述codeString是錯誤代碼msgString是錯誤信息datajson對象是返回分頁對象的結果集>objectsjson數組是>>lostPropertyCodeString是遺失物編號>>lostPropertyNameString是遺失物名稱>>isPublicityInteger否是否公示(0為是，1為否)>>lostPropertyTypeString是遺失物類型>>pickupTimeDate是撿拾物品時間>>createTimeDate是登記時間>>picListjson數組否照片集合>>>urlString否圖片id>>>typeInteger是類型，1：失物圖片，2.失物登記表圖片，3：認領圖片，4：認領表圖片，5：過期物品清單圖片>>>sortInteger否排序>>>isPublicityInteger是是否公示(0為是，1為否)>>>versionString否版本>>>createTimeString是創(chuàng)建時間>>>updateTimeString是修改時間>>airportNameString是登記機場>>pickupSiteString是拾撿地點>totalCountInteger是結果集總數>totalPageInteger是總頁數>currentPagInteger是當前頁數表SEQ表\*ARABIC7輸出示例{"code":"0","msg":"success","data":{"objects":[{"lostPropertyCode":"BCD2020121536730","lostPropertyName":"藍色雨傘","lostPropertyType":9,"pickupTime":"2020-09-2100:00:00","createTime":"2020-12-1512:51:58","picList":[{"createTime":"2020-12-1512:51:58","updateTime":"2020-12-1512:51:58","url":"2d250a266e716854bb8603dd211828670d0ecd111a653d05735e6ca630f3784819c0237e6063916c02224ef5a2352973c2592d49203a342ce2bf9ba70de16920","type":1,"version":"1.2.0","sort":null,"isPublicity":0}],"airportName":"生產外部接口機場","airportCode":"BCD","airportPhone":null,"pickupSite":"安檢機旁邊","isPublicity":0,"lostPropertySubType":93}],"totalCount":3,"totalPage":1,"currentPage":1}}查詢遺失物品詳情接口根據接收參數，查詢對應條件下的遺失物品詳情信息。輸入參數Header見REF_Ref25808\h表8。參數名類型是否必需描述requestIdString是UUIDAuthorizationString是"Bearer"+access_Token（BearerToken方式的認證信息）clientIdString是線下分配客戶IdContent-TypeString是固定寫法，內容如下application/json;charset=utf-8表SEQ表\*ARABIC8Param見REF_Ref25864\h表9。參數名類型是否必需描述lostPropertyCodeString是遺失物品編號表SEQ表\*ARABIC9輸出參數輸出參數見REF_Ref25916\h表10。參數名類型是否必需描述codeString是錯誤代碼msgString是錯誤信息datajson對象是返回對象的結果>lostPropertyCodeString是遺失物編號>lostPropertyNameString是遺失物名稱>typeString是遺失物品一級分類>subTypeInteger是遺失物品類型二級分類>pickupTimeDate是撿拾物品時間>createTimeDate是登記時間>pickupSiteString否撿拾地點>airportCodeString是登記機場三字碼>isPublicityString否是否公示(0為是，1為否)>isCheckedString是是否經過安檢>descriptionString否遺失物詳細描述>lostPictureString否遺失物照片-存放照片路徑(HTTPURL)>registryPhotoString否登記表照片存放路徑(HTTPURL)>statusString是狀態(tài)>depotInfoString否入庫位置（航站樓,位置）>handPersonNameString否交件人姓名>handPersonPhoneString否交件人電話>airPortString是收件機場>handPersonUnitString否交件單位>airportLostIdString否機場平臺存儲Id>pickupAreaInteger是1：安檢口2：登機口3：隔離區(qū)內4：隔離區(qū)外5：值機柜臺6：其他區(qū)域注*取值為6時pickupSite必填>flightNumberString否航班號>checkedUserString否安檢員>isPreciousInteger是是否貴重物品0：是1：否>registerSiteString否登記地點>parentAirportLostIdString否主失物Id當前對象為子失物時該字段有效>picListjson數組否照片集合>>urlString否圖片id>>typeInteger是類型，1：失物圖片，2.失物登記表圖片，3：認領圖片，4：認領表圖片，5：過期物品清單圖片>>sortInteger否排序>>isPublicityInteger是是否公示(0為是，1為否)>>versionString否版本>>createTimeString是創(chuàng)建時間>>updateTimeString是修改時間>subLostPropertyjson數組否子失物集合表SEQ表\*ARABIC10輸出示例{"code":"0","msg":"success","data":{"lostPropertyCode":"BCD2020121536742","lostPropertyName":"白色雨傘","pickupTime":"2020-09-2100:00:00","createTime":"2020-12-1512:52:12","pickupSite":"安檢機旁邊","description":"暫無","picList":[{"createTime":"2020-12-1512:52:12","updateTime":"2020-12-1512:52:12","url":"2d250a266e716854bb8603dd211828670d0ecd111a653d05735e6ca630f3784819c0237e6063916c02224ef5a2352973c2594749203a342ce2bf9ba70de16920","type":1,"version":"1.2.0","sort":null,"isPublicity":0}],"handPersonName":"張磊","handPersonUnit":"后勤保障部","handPersonPhone":,"type":9,"subType":93,"status":2,"airportLostId":"CUSBCD20201215000003","airport":"生產外部接口機場","airportCode":"BCD","registryPhoto":null,"isPublicity":0,"isChecked":0,"depotInfo":null,"pickupArea":6,"flightNumber":"CA1836","checkedUser":"李明","storeTier":null,"isPrecious":1,"registerSite":null,"parentAirportLostId":null,"subLostProperty":[]}}圖片上傳接口上傳圖片，獲取圖片id，上傳圖片格式為JPG、JPEG、PNG其中一種，返回圖片id，記錄此id，并在上傳失物時，將此id值賦予接口，此id為失物與圖片關聯(lián)關系。輸入參數Header見REF_Ref25991\h表11。參數名類型是否必需描述requestIdString是UUIDAuthorizationString是"Bearer"+access_Token（BearerToken方式的認證信息）clientIdString是線下分配客戶IdContent-TypeString是application/x-www-form-urlencoded表SEQ表\*ARABIC11Param見REF_Ref26295\h表12。參數名類型是否必需描述fileFile是文件流表SEQ表\*ARABIC12輸出參數輸出參數見REF_Ref26200\h表13。參數名類型是否必需描述codeString是錯誤代碼msgString是錯誤信息dataString是照片id表SEQ表\*ARABIC13輸出示例{"code":"0","msg":"success","data":"2d250a266e716854bb8603dd211891670d0ecd111a653d05735e6ca630f37848d30c042772cb42d6d208e815141b077e26278e10d5b4c4bbdf5fc2d19b317e47"}通過圖片id獲取圖片信息據查詢到的公示失物信息中的失物照片id，來獲取該路徑下圖片信息。輸入參數Header見REF_Ref26350\h表14。參數名類型是否必需描述requestIdString是UUIDAuthorizationString是"Bearer"+access_Token（BearerToken方式的認證信息）Content-TypeString是application/x-www-form-urlencoded表SEQ表\*ARABIC14Param見REF_Ref26393\h表15。參數名類型是否必需描述無json數組是可同時獲取多條記錄表SEQ表\*ARABIC15輸入示例["2d250a266e736854bb8603dd211891670d0ecd111a653d05735e6ca630f37848d30c042772cb42d6d208e815141b077e9534ceea62451d00e5b56f665f84e69f","2d250a266e736854bb8603dd211891670d0ecd111a653d05735e6ca630f37848d30c042772cb42d6d208e815141b077e70e5b59361ea494afccf772e8672db80"]輸出參數輸出參數見REF_Ref26575\h表16。參數名類型是否必需描述codeString是代碼msgString是信息datajson數組否圖片集合>>imageString否圖片base64編碼數據>>imageTypeString否圖片類型>>imageNameString否圖片名稱>>imageUrlString否圖片路徑表SEQ表\*ARABIC16輸出示例{"code":"0","msg":"success","data":[{"image":"data:image/png;base64,iVBORw0KGgoAAAYYxE2CI2oB4bUI9V4uZSZtmnTHZCRDN6xE912f6pR21g0yKgWpCqFSSXgtX7c4DamlTlQnWS3vkfAupxJlJQ/wmgNqTJGrMlnD9Zf29WE6ozDyrVxP/u/wE/Ajt17SyqsAAAAABJRU5ErkJggg==","imageType":null,"imageName":null,"imageUrl":"e55618db01e7a9714b2d2fc969d5631bef515bf6442ebdf0be6d3c87e1553689c10d87658b6545a88b7a56775fdf629ec1da58b19f1a3f562fec31004a223d86"},{"image":"data:image/png;base64,iVBORw0KGgoyLzNQzcsMVPMyLzNQzcu8/sL1/wF0j0mAE6n3kwAAAABJRU5ErkJggg==","imageType":null,"imageName":null,"imageUrl":"e55618db01e7a9714b2d2fc969d5631bef515bf6442ebdf0be6d3c87e1553689c10d87658b6545a88b7a56775fdf629e84e2e90b1958a8049a8fae5ce46355da"}]}單一遺失物品信息傳輸接口根據接收參數，錄入對應的遺失物品信息，此接口有公示標記與失物狀態(tài)標記、分類信息等，會影響失物是否能夠被旅客查詢到，上傳失物前請先上傳圖片，記錄圖片id，維護到此失物中。輸入參數Header見REF_Ref26637\h表17。參數名類型是否必需描述requestIdString是UUIDAuthorizationString是"Bearer"+access_Token（BearerToken方式的認證信息）clientIdString是線下分配客戶IdContent-TypeString是固定寫法，內容如下application/json;charset=utf-8表SEQ表\*ARABIC17Param見REF_Ref26686\h表18。參數名類型是否必需長度描述lostPropertyNameString是80遺失物名稱typeInteger是4遺失物類型一級分類subTypeInteger是4遺失物品類型二級分類pickupTimeString是撿拾物品時間(yyyy-MM-dd)createTimeString是登記時間(yyyy-MM-dd)pickupSiteString否20撿拾地點isPublicityInteger是是否公示（0:是1:否）isCheckedInteger是是否經過安檢（0:是1:否）isShowInteger否是否展示給其他機場，默認展示(0:是1:否)descriptionString是100遺失物詳細描述lostPictureString否遺失物品照片id集合,多個逗號分割,最多5個picListjson數組否遺失物品照片數組(自定義是否公式)最多5個>urlString是圖片id,圖片上傳接口的返回數據>isPublicityInteger是是否公示（0:是1:否）statusInteger是狀態(tài)（1.認領中、2.無人認領、3.過保質期4.過保存期5.已認領6.過期已處理，7.已刪除）handPersonNameString是30交件人姓名handPersonUnitString否20交件單位handPersonPhoneString否20交件人電話dealStatusInteger否用于返回處理狀態(tài)，0表示成功，非0表示錯誤dealInfoString否用于批量處理時，返回單個處理描述，airportLostIdString是20機場平臺存儲Id（以本機場三字碼開頭）airportLostId為必填字段該值代表遺失物品的全局唯一Id若airportLostId不存在則執(zhí)行新增，若airportLostId存在則執(zhí)行更新操作無論新增或修改操作,此字段必填pickupAreaInteger是1：安檢口2：登機口3：隔離區(qū)內4：隔離區(qū)外5：值機柜臺6：其他區(qū)域注*取值為6時pickupSite必填flightNumberString否40航班號checkedUserString否10安檢員isPreciousInteger是是否貴重物品0：是1：否registerSiteString否80登記地點parentAirportLostIdString否20主失物Id如登記一個遺失物品背包（主失物），包中的物品也需要登記（子失物），那么該字段只在登記子失物時有效，且取值為主失物airportLostId子失物登記時該字段必填表SEQ表\*ARABIC18輸入示例{"lostPropertyName":"黃色雨傘","type":9,"subType":93,"pickupTime":"2020-09-21","createTime":"2020-09-21","isChecked":0,"description":"暫無","status":2,"handPersonName":"張磊","handPersonUnit":"后勤保障部","handPersonPhone":,"airportLostId":"CUSBCD20201215000001","pickupArea":6,"pickupSite":"安檢機旁邊","flightNumber":"CA1836","checkedUser":"李明","isPrecious":1,"isPublicity":0,"isShow":0,"lostPicture":"2d250a266e716854bb8603dd211828670d0ecd111a653d05735e6ca630f3784819c0237e6063916c02224ef5a2352973c4392d49203a342ce2bf9ba70de16920"}輸出參數輸出參數見表19。參數名類型是否必需描述codeString是錯誤代碼msgString是錯誤信息datajson對象是返回對象的結果>lostPropertyCodeString否遺失物編號(請求參數不必填寫)>lostPropertyNameString是遺失物名稱>typeInteger是遺失物類型一級分類>subTypeInteger是遺失物品類型二級分類>pickupTimeString是撿拾物品時間(yyyy-MM-dd)>createTimeString是登記時間(yyyy-MM-dd)>pickupSiteString否撿拾地點>isPublicityInteger是是否公示（0:是1:否）>isCheckedInteger是是否經過安檢（0:是1:否）>isShowInteger否是否展示給其他機場，默認展示(0:是1:否)>descriptionString是遺失物詳細描述>lostPictureString否遺失物品照片id集合,多個逗號分割,最多5個>statusInteger是狀態(tài)（1.認領中、2.無人認領、3.過保質期4.過保存期5.已認領6.過期已處理，7.已刪除）>handPersonNameString是交件人姓名>handPersonUnitString否交件單位>handPersonPhoneString否交件人電話>dealStatusInteger否用于返回處理狀態(tài)，0表示成功，非0表示錯誤>dealInfoString否用于批量處理時，返回單個處理描述，>airportLostIdString是機場平臺存儲Id（以本機場三字碼開頭）無論新增或修改操作,此字段必填>pickupAreaInteger是1：安檢口2：登機口3：隔離區(qū)內4：隔離區(qū)外5：值機柜臺6：其他區(qū)域注*取值為6時pickupSite必填>flightNumberString否航班號>checkedUserString否安檢員>isPreciousInteger是是否貴重物品0：是1：否>registerSiteString否登記地點>parentAirportLostIdString否主失物Id如登記一個遺失物品背包（主失物），包中的物品也需要登記（子失物），那么該字段只在登記子失物時有效，且取值為主失物airportLostId子失物登記時該字段必填表SEQ表\*ARABIC19輸出示例{"code":"0","msg":"success","data":{"lostPropertyCode":"BCD2020121536599","lostPropertyName":"黃色雨傘","pickupTime":"2020-09-21","createTime":"2020-09-21","pickupSite":"安檢機旁邊","description":"暫無","lostPicture":"2d250a266e716854bb8603dd211828670d0ecd111a653d05735e6ca630f3784819c0237e6063916c02224ef5a2352973c4392d49203a342ce2bf9ba70de16920","handPersonName":"張磊","handPersonUnit":"后勤保障部","handPersonPhone":,"dealInfo":"是","dealStatus":0,"type":9,"subType":93,"status":2,"airportLostId":"CUSBCD20201215000001","isChecked":0,"isShow":0,"isPublicity":0,"saveTime":null,"pickupArea":6,"flightNumber":"CA1836","checkedUser":"李明","storeTier":null,"isPrecious":1,"registerSite":null,"parentAirportLostId":null,"saveUnit":null}}批量遺失物品信息傳輸接口根據接收參數，批量錄入對應的遺失物品信息。輸入參數Header見REF_Ref26820\h表20。參數名類型是否必需描述requestIdString是UUIDAuthorizationString是"Bearer"+access_Token（BearerToken方式的認證信息）clientIdString是線下分配客戶IdContent-TypeString是固定寫法，內容如下application/json;charset=utf-8表SEQ表\*ARABIC20參數名類型是否必需長度描述lostPropertyNameString是80遺失物名稱typeInteger是4遺失物類型一級分類subTypeInteger是4遺失物品類型二級分類pickupTimeString是撿拾物品時間(yyyy-MM-dd)createTimeString是登記時間(yyyy-MM-dd)pickupSiteString否20撿拾地點isPublicityInteger是是否公示（0:是1:否）isCheckedInteger是是否經過安檢（0:是1:否）isShowInteger否是否展示給其他機場，默認展示(0:是1:否)descriptionString是100遺失物詳細描述lostPictureString否遺失物品照片id集合,多個逗號分割,最多5個picListjson數組否遺失物品照片數組(自定義是否公式)最多5個>urlString是圖片id,圖片上傳接口的返回數據>isPublicityInteger是是否公示（0:是1:否）statusInteger是狀態(tài)（1.認領中、2.無人認領、3.過保質期4.過保存期5.已認領6.過期已處理，7.已刪除）handPersonNameString是30交件人姓名handPersonUnitString否20交件單位handPersonPhoneString否20交件人電話dealStatusInteger否用于返回處理狀態(tài)，0表示成功，非0表示錯誤dealInfoString否用于批量處理時，返回單個處理描述，airportLostIdString是20機場平臺存儲Id（以本機場三字碼開頭）airportLostId為必填字段該值代表遺失物品的全局唯一Id若airportLostId不存在則執(zhí)行新增，若airportLostId存在則執(zhí)行更新操作無論新增或修改操作,此字段必填pickupAreaInteger是1：安檢口2：登機口3：隔離區(qū)內4：隔離區(qū)外5：值機柜臺6：其他區(qū)域注*取值為6時pickupSite必填flightNumberString否40航班號checkedUserString否10安檢員isPreciousInteger是是否貴重物品0：是1：否registerSiteString否80登記地點parentAirportLostIdString否20主失物Id如登記一個遺失物品背包（主失物），包中的物品也需要登記（子失物），那么該字段只在登記子失物時有效，且取值為主失物airportLostId子失物登記時該字段必填表SEQ表\*ARABIC21Param，請求參數為json數組,以下為數組中每個對象的屬性說明,遺失物品詳請集合，最大支持200條（見REF_Ref26892\h表21）。輸入示例[{"lostPropertyName":"紅色帽子","type":9,"subType":86,"pickupTime":"2020-09-22","createTime":"2020-09-22","pickupSite":"ZH8150","isPublicity":1,"isChecked":0,"isShow":0,"description":"紅色帽子","status":2,"handPersonName":"張三","handPersonUnit":"后勤","handPersonPhone":,"airportLostId":"PKX202103220001","pickupArea":1,"flightNumber":"MH370","checkedUser":"王順4","isPrecious":0,"registerSite":"航站樓"},{"lostPropertyName":"藍色帽子","type":9,"subType":86,"pickupTime":"2020-09-22","createTime":"2020-09-22","pickupSite":"ZH8150","isPublicity":1,"isChecked":0,"isShow":0,"description":"藍色帽子","lostPicture":null,"status":2,"handPersonName":"李文","handPersonUnit":"財務","handPersonPhone":,"airportLostId":"PKX2021032200012","pickupArea":1,"flightNumber":"MH370","checkedUser":"王順5",