在系統開發過程中,我們經常會涉及到和第三方服務聯調的過程。關於和第三方進行接口聯調,稍微說下自己的想法。
1. 接口文檔
接口文檔是我們了解第三方接口的基礎。通過接口文檔我們能大致了解每個接口的功能,調用的場景是什么,調用時需要傳哪些字段,調用過程中是否需要進行加解密等。所以在和第三方進行開發聯調前,你一定要問第三方要一份詳細的接口文檔。
2. 梳理接口文檔
拿到接口文檔后,你需要仔細閱讀接口文檔,下面的這些問題需要你重點關注。
- 第三方提供的接口是否能滿足你們自己的業務需求?假如提供的接口不能滿足你的業務需求,你需要讓對方補充接口,如果對方不能補充的,你就要考慮下其他方案,同時想下還有沒有和第三方繼續對接的需要;
- 理清楚第三方提供的每個接口的功能,弄清楚這些接口在你們的業務場景中的調用時機是什么,最好能畫出一個流程圖或者時序圖,這樣會更加清楚;
- 確認下接口請求是否需要加解密操作,如果需要最好是讓對方提供一個加解密的demo,這樣會減少出錯的可能性,加快聯調速速;
- 確認對接過程中是否需要第三方為我們分配渠道號、產品代碼、加解密秘鑰等這些固定參數,如果需要的話,提前向第三方申請,這樣也會加快開發進度;這些參數包括開發、測試和生產的,一般情況下生產的參數在聯調階段都給不出來,你可以記一個todo-list,以免上線時忘記;
- 確認第三方的接口調用地址,你們的系統是否能夠調得通,如果不通的話,你可能要提前通知你們的運維人員開通網絡防火牆(包括測試和生產)
- 梳理接口的入參和返參,你要明確每個字段的含義是什么,怎么傳,你們系統是否能提供這個字段,返回參數哪些是你需要的,等等。
梳理接口階段你必須做完上面這些工作才算合格。不要覺得這些事情不重要,這些梳理工作能讓你提前發現很多問題。而等到開發聯調時才發現,可能會讓你的“手足無措”。
3. 開發聯調
雖然有接口文檔,但是由於種種問題,接口的實際運行和我們理解的總是有出入的。開發聯調階段就是驗證接口是否滿足接口文檔的描述。如果你的接口文檔梳理的很到位的話,開發聯調階段應該是非常輕松的。
這邊有個小建議:就是在調用第三方接口時,對於第三方系統拋出的異常不要處理,直接向上拋出,讓你們系統的業務代碼處理。
4. 上線階段
當開發聯調完成后,就是要系統上線了。上線前我們應該要確認好下面的事情:
- 三方系統是否能支持我們的上線排期;
- 我們的系統和三方系統網絡是否已經開通;
- 渠道號、產品代碼、秘鑰這些參數生產環境是否配置正確;
確認完這些事情后上線一般就沒什么大問題了。