中央業(yè)務(wù)平臺(tái)數(shù)據(jù)下發(fā)接口規(guī)范-文庫(kù)吧資料
2025-04-24 07:41本頁(yè)面
【正文】 ning 目錄各省公司登陸后可以讀取相關(guān)接口文件，各省公司取走之后需要?jiǎng)h除原文件以釋放空間；2. 當(dāng)省公司下載下來(lái)的文件發(fā)生遺失或者損壞，可以到 backup 目錄下重新下載。數(shù)據(jù)接收方的接口系統(tǒng)應(yīng)在 2 小時(shí)內(nèi)讀取當(dāng)日接口文件并刪除。各省公司如果發(fā)現(xiàn)下發(fā)的數(shù)據(jù)有錯(cuò)誤或者未及時(shí)下發(fā)，需和有限公司聯(lián)系，由有限公司更新數(shù)據(jù)。? 文件中單行記錄的長(zhǎng)度驗(yàn)證實(shí)際接口數(shù)據(jù)文件中的每行記錄長(zhǎng)度是否與本規(guī)范定義的長(zhǎng)度一致。11 / 29? 文件的大?。ㄗ止?jié)數(shù)）驗(yàn)證接口校驗(yàn)文件中記載的文件大小與實(shí)際接口數(shù)據(jù)文件的文件大小是否一致。? 數(shù)據(jù)日期驗(yàn)證接口校驗(yàn)文件中記載的數(shù)據(jù)日期與接口數(shù)據(jù)文件名中的數(shù)據(jù)日期（參見(jiàn)文件命名說(shuō)明）是否一致。? 時(shí)間類(lèi)型? 統(tǒng)一采用 HHMMSS 格式? HH 為兩位數(shù)字，必須是有效的小時(shí)（0023），24 小時(shí)制? MM 為兩位數(shù)字，必須是有效的分鐘（0059）? SS 為兩位數(shù)字，必須是有效的秒（0059）? 對(duì)于不符合時(shí)間約束規(guī)則的時(shí)間值，處理方式同 NULL 文件級(jí)校驗(yàn)文件級(jí)校驗(yàn)是指根據(jù)源數(shù)據(jù)提供方提供的接口校驗(yàn)文件信息，對(duì)傳輸?shù)慕涌跀?shù)據(jù)文件進(jìn)行校驗(yàn)，校驗(yàn)內(nèi)容如下：? 接口數(shù)據(jù)文件名稱(chēng)? 根據(jù)接口校驗(yàn)文件中記錄的文件名，查找“接口數(shù)據(jù)文件目錄”（參見(jiàn)文件目錄的劃分）下該接口數(shù)據(jù)文件是否存在。? 日期類(lèi)型? 日期類(lèi)型統(tǒng)一采用 YYYYMMDD 格式，YYYYMMDD 必須為有意義的日期? YYYY 為四位數(shù)字，必須是有效的年份? MM 為兩位數(shù)字，必須是有效的月份（0112）10 / 29? DD 為兩位數(shù)字，必須是有效的日期（0131）? 對(duì)于不符合日期約束規(guī)則的日期值，處理方式存在以下兩種情況：1) 無(wú)值的日期或者無(wú)意義的日期，這時(shí)在接口中一律以“00010101”（公元元年 1 月 1 日）填充；2) 接口單元中的“失效日期”在表示“未失效”含義時(shí)，一律以“29991231”（公元 2999 年 12 月 31 日）填充。? 編碼格式? 漢字：GBK 內(nèi)碼? 西文：ASCII 碼? 數(shù)字格式? 在接口數(shù)據(jù)文件中，數(shù)字的表示必須規(guī)范，小數(shù)點(diǎn)的前后必需有數(shù)字，如： 或 ,不能用“.01”或“34.”表示；? 符號(hào)處理：數(shù)字最高位的左邊第一位為符號(hào)位。8 / 29 接口文件格式接口數(shù)據(jù)文件的格式請(qǐng)參見(jiàn)下文中對(duì)各接口單元的具體描述。如果數(shù)據(jù)的實(shí)際字節(jié)長(zhǎng)度小于方案中要求的字段長(zhǎng)度，則必須用空格補(bǔ)齊（右補(bǔ)齊） ，如果數(shù)據(jù)的實(shí)際長(zhǎng)度大于方案中的要求，則需要截?cái)啵ㄈ缱址枋觯?。為了保證接口數(shù)據(jù)的一致性，避免各類(lèi)數(shù)據(jù)類(lèi)型和格式錯(cuò)誤，在形成所傳輸?shù)?ASCII 格式文件之前，將數(shù)據(jù)轉(zhuǎn)成本接口方案所規(guī)定的數(shù)據(jù)類(lèi)型和格式。? 所有的文件名稱(chēng)中用到的字母均需小寫(xiě)。重傳序號(hào)是用于描述同一個(gè)接口單元的同一數(shù)據(jù)日期內(nèi)，由于數(shù)據(jù)異常、校驗(yàn)重傳等原因，需要重新生成、上傳數(shù)據(jù)時(shí)，則需要通過(guò)重傳序號(hào)來(lái)描述當(dāng)前接口文件的重傳順序號(hào)：00：表示該數(shù)據(jù)日期的接口文件是首次正常生成數(shù)據(jù)上傳（非重傳）01：表示該數(shù)據(jù)日期的接口文件是第一次重傳02：表示該數(shù)據(jù)日期的接口文件是第二次重傳…N+1: 表示該數(shù)據(jù)日期的接口文件是第 N+1 次重傳7 / 29? 序列號(hào)序列號(hào)必須是三位數(shù)字型字符。例如：記錄日志文件時(shí)，操作日志文件的日期即為當(dāng)時(shí)取得的操作系統(tǒng)時(shí)間。按日抽取的數(shù)據(jù)文件，其數(shù)據(jù)日期就是數(shù)據(jù)的發(fā)生日期；按月抽取的數(shù)據(jù)文件，則數(shù)據(jù)日期取數(shù)據(jù)發(fā)生的年月（對(duì)數(shù)據(jù)日期有特殊要求的接口單元，將在其“數(shù)據(jù)要求”中詳細(xì)描述）。? 接口單元編碼接口單元編碼是每一個(gè)接口單元的唯一標(biāo)識(shí)，各接口單元的編碼請(qǐng)參見(jiàn)下文。 接口文件命名規(guī)則 中央業(yè)務(wù)平臺(tái)列表? 飛信平臺(tái)5 / 29 接口單元編碼規(guī)則對(duì)中央業(yè)務(wù)平臺(tái)的各接口單元的編碼采用平臺(tái)代碼與序列號(hào)組成，其中平臺(tái)代碼為三位數(shù)字，序列號(hào)為兩位數(shù)值，各接口單元的編碼規(guī)則是：平臺(tái)代碼序列號(hào) 。 數(shù)據(jù)接收方的責(zé)任? 負(fù)責(zé)與源數(shù)據(jù)提供方的信息交互和溝通。? 數(shù)據(jù)的提供方負(fù)責(zé)數(shù)據(jù)的一致性控制，保證生成的接口數(shù)據(jù)與中央業(yè)務(wù)平臺(tái)中存儲(chǔ)的數(shù)據(jù)一致。? 保證接口數(shù)據(jù)文件的大小不能超過(guò)2GB，如果接口數(shù)據(jù)文件太大，必須按要求將文件拆分，拆分后的文件命名參見(jiàn)文件分類(lèi)及命名規(guī)則。每月新增數(shù)據(jù) 指抽取每月 1 日 00：00 時(shí)始至月未最后一日 24：00 止，新產(chǎn)生的數(shù)據(jù)。每月全量 指抽取每月月未最后一日 24：00 時(shí)，所有數(shù)據(jù)的最新?tīng)顟B(tài)快照。每月增量 指抽取每月 1 日 00：00 時(shí)始至月未最后一日 24：00 止，發(fā)生變化的、新產(chǎn)生的數(shù)據(jù)最新?tīng)顟B(tài)的快照。包括傳輸日志、鏈路狀態(tài)日志、告警日志等。日志文件 指接口系統(tǒng)在操作過(guò)程中進(jìn)行數(shù)據(jù)處理的記錄文件。接口校驗(yàn)文件 指由源數(shù)據(jù)提供方在每一個(gè)抽取周期中，針對(duì)每個(gè)接口數(shù)據(jù)文件產(chǎn)生的文件級(jí)校驗(yàn)所依據(jù)的信息。 參考文檔《中國(guó)移動(dòng)省級(jí)經(jīng)營(yíng)分析系統(tǒng)與源系統(tǒng)接口規(guī)范 》《中國(guó)移動(dòng)一級(jí)經(jīng)營(yíng)分析系統(tǒng)省級(jí)數(shù)據(jù)接口規(guī)范》2 / 29 縮略語(yǔ)本文將用到以下名詞及縮寫(xiě)：縮寫(xiě) 專(zhuān)用名詞有限公司 中國(guó)移動(dòng)通信有限公司一經(jīng)系統(tǒng) 中國(guó)移動(dòng)一級(jí)經(jīng)營(yíng)分析系統(tǒng)二經(jīng)系統(tǒng) 中國(guó)移動(dòng)省級(jí)經(jīng)營(yíng)分析系統(tǒng)飛信 基于手機(jī)應(yīng)用以及與 Inter 深度互通的即時(shí)通訊產(chǎn)品中央業(yè)務(wù)平臺(tái) 泛指在全網(wǎng)一點(diǎn)集中建設(shè)運(yùn)營(yíng)的業(yè)務(wù)平臺(tái) 約定名詞 說(shuō)明源數(shù)據(jù)提供方 有限公司一經(jīng)系統(tǒng)數(shù)據(jù)接收方 各省公司二經(jīng)系統(tǒng)接口文件 指源數(shù)據(jù)提供方根據(jù)本方案要求生成的供二經(jīng)使用的文件，包括接口數(shù)據(jù)文件、接口校驗(yàn)文件。 起草單位本接口規(guī)范由中國(guó)移動(dòng)通信有限公司業(yè)務(wù)支撐系統(tǒng)部負(fù)責(zé)起草。 適用范圍本接口規(guī)范是中國(guó)移動(dòng)一級(jí)經(jīng)營(yíng)分析系統(tǒng)中央業(yè)務(wù)平臺(tái)接口數(shù)據(jù)下發(fā)的基本依據(jù)。1 / 29中國(guó)移動(dòng)一級(jí)經(jīng)營(yíng)分析系統(tǒng)中央業(yè)務(wù)平臺(tái)數(shù)據(jù)下發(fā)接口規(guī)范飛信分冊(cè) 中國(guó)移動(dòng)通信有限公司2022 年 07 月2 / 29文檔變更記錄序號(hào) 變更內(nèi)容說(shuō)明 版本號(hào) 修訂日期 生效日期1 文檔建立 20220703 2022 年 7 月i / 29目 錄1 總則 ......................................................................................................1 背景 ..................................................................................................................1 目的 ..................................................................................................................1 適用范圍 .........................
公司管理相關(guān)推薦
鄂ICP備17016276號(hào)-1