服務(wù)總線接口規(guī)范標(biāo)準(zhǔn)(存儲(chǔ)版)
【正文】 5 調(diào)用的服務(wù)已注銷7 調(diào)用的服務(wù)已關(guān)閉11 調(diào)用的服務(wù)不存在1 服務(wù)調(diào)用失敗398 平臺(tái)內(nèi)部異常平臺(tái)異常399 平臺(tái)其他異常其他異常 999 其他異常測試異常 601 測試接口未實(shí)現(xiàn)業(yè)務(wù)定義異常1000. . . .. . 學(xué)習(xí)好幫手如果遇到上述類似異常代碼或信息，可以和平臺(tái)維護(hù)人員聯(lián)系幫助解決。 服務(wù)接口參數(shù)應(yīng)符合接口規(guī)范，服務(wù)總線將定期對服務(wù)調(diào)用異常、失敗、異常代碼等進(jìn)行統(tǒng)計(jì)，給出服務(wù)接口的符合度。不奮斗就是每天都很容易，可一年一年越來越難。是狼就要練好牙，是羊就要練好腿。第 7 章 服務(wù)治理 目標(biāo) 所有域的服務(wù)按照協(xié)議規(guī)范全部接入服務(wù)總線，避免出現(xiàn)服務(wù)未在服務(wù)總線直接使用。 傳輸加密對于安全非常高的場合，建議全流程采用 HTTPS 協(xié)議進(jìn)行加密傳輸，如繳費(fèi)等場景。第 4 章 安全控制 訪問鑒權(quán)服務(wù)總線對外提供統(tǒng)一安全控制策略。表格 31 系統(tǒng)級參數(shù)參數(shù)名 類型 是否必需 描述Send string 是客戶端所屬系統(tǒng)編碼，填寫請參考 節(jié)（系統(tǒng)標(biāo)志全部采用此編碼）servCode string 是客戶端需要訪問的服務(wù)編碼，由服務(wù)總線在注冊后統(tǒng)一提供. . . .. . 學(xué)習(xí)好幫手msgId string 是由調(diào)用方系統(tǒng)按照 OIP 規(guī)則生成的唯一標(biāo)識(shí)一次調(diào)用的字符串，長度小于 64位。其中/oip/rest保持不變。 數(shù)據(jù)量原則服務(wù)總線所傳遞的單條消息大小原則上不大于 1M，否則應(yīng)建議采用文件傳輸、接口表傳輸、直連等連接方式。為有效提高組合服務(wù)的效率，跨系統(tǒng)的組合服務(wù)由服務(wù)總線調(diào)用. . . .. . 學(xué)習(xí)好幫手不同的原子服務(wù)實(shí)現(xiàn)組合，系統(tǒng)內(nèi)的組合服務(wù)由服務(wù)提供方在應(yīng)用內(nèi)部進(jìn)行組合。第 2 章 服務(wù)設(shè)計(jì)原則由于各個(gè)系統(tǒng)和平臺(tái)之間存在差異性，為確保安徽電信服務(wù)總線的穩(wěn)定高效，服務(wù)設(shè)計(jì)原則如下： 接口協(xié)議統(tǒng)一原則所有服務(wù)的接口均基于 Http 協(xié)議。2) 當(dāng)服務(wù)使用方調(diào)用服務(wù)總線提供的服務(wù)時(shí)，為該服務(wù)使用方提供開發(fā)依據(jù)。 名詞解釋. . . .. . 學(xué)習(xí)好幫手1) 服務(wù)提供方：提供原始服務(wù)，并將服務(wù)發(fā)布到服務(wù)總線的內(nèi)部業(yè)務(wù)系統(tǒng)、第三方企業(yè)或個(gè)人。服務(wù)提供方和服務(wù)消費(fèi)方必須同時(shí)使用同一種格式進(jìn)行數(shù)據(jù)交互。報(bào)文統(tǒng)一采用 UTF8進(jìn)行編碼。 持久化原則服務(wù)使用方在使用服務(wù)的過程中，由服務(wù)總線進(jìn)行整個(gè)過程的日志記錄，并對調(diào)用的詳細(xì)信息進(jìn)行持久化，便于對. . . .. . 學(xué)習(xí)好幫手賬和稽核。msgId=crm_20220718_10001amp。服務(wù)請求需經(jīng)過多個(gè)系統(tǒng)或多個(gè)系統(tǒng)模塊，為了有效標(biāo)志出一次業(yè)務(wù)請求經(jīng)過的所有調(diào)用，服務(wù)調(diào)用方在請求時(shí)生成一唯一的流水號(hào)，服務(wù)總線在多次調(diào)用過程中將會(huì)保持此交易流水號(hào)一致，服務(wù)提供方也應(yīng)記錄此交易流水號(hào)。該部分由使用方進(jìn)行申請，平臺(tái)完成注冊，同時(shí)為服務(wù)使用方分配可使用服務(wù)的權(quán)限。第 6 章 服務(wù)注冊、注銷、變更、調(diào)用流程 服務(wù)注冊的流程服務(wù)注冊和變更：由服務(wù)提供方在 ITSM 發(fā)起申請，經(jīng)服務(wù)評審后，由 ITSM 調(diào)用服務(wù)總線提供的能力進(jìn)行注冊和變更。 服務(wù)返回的業(yè)務(wù)數(shù)據(jù)應(yīng)符合注冊時(shí)提供的 JSON Schema，不符合的則認(rèn)為是注冊信息不全或異常升級。能干的人，不在情緒上計(jì)較，只在做事上認(rèn)真；無能的人！不在做事上認(rèn)真，只在情緒上計(jì)較。服務(wù)目錄示例：服務(wù)大類 服務(wù)小類 服務(wù)名稱 提供系統(tǒng) 服務(wù)編碼 輸入?yún)?shù) 輸出參數(shù) 報(bào)文示例 異常描述工號(hào)登陸接口 CRM 工號(hào),密碼 工號(hào)對象 組織視圖 組織視圖 參考資料：JSON Schema: An Extension to HTTP : Digest Access Authentication： 寧可累死在路上，也不能閑死在家里！寧可去碰壁，也不能面壁。 服務(wù)
公司管理相關(guān)推薦
鄂ICP備17016276號(hào)-1