后端開發(fā)完接口才給出接口文檔，合理嗎？你怎么看？一個非常好的問題。我是一個web應(yīng)用程序架構(gòu)師，多年來一直致力于回答這個問題。歡迎跟我來了解更多。后端提供接口文檔為時已晚，這是合理和不合理的。根據(jù)具體

后端開發(fā)完接口才給出接口文檔，合理嗎？你怎么看？

一個非常好的問題。我是一個web應(yīng)用程序架構(gòu)師，多年來一直致力于回答這個問題。歡迎跟我來了解更多。

后端提供接口文檔為時已晚，這是合理和不合理的。根據(jù)具體情況，總有解決辦法。讓我談?wù)勎业挠^點。

不合理：成熟的技術(shù)團(tuán)隊重視功能設(shè)計，在編寫代碼之前有完整的技術(shù)文檔和功能定義。即使在TDD測試驅(qū)動的開發(fā)模式下，測試數(shù)據(jù)已經(jīng)準(zhǔn)備好了，那么接口邏輯就已經(jīng)確定了接口文檔是否編寫好了，理清它們是很自然的。

-第一，主觀原因。原因是多方面的，比如趕進(jìn)度，沒有時間，不懶得寫，甚至在開發(fā)前沒有仔細(xì)設(shè)計，在做的時候也有變化。真的沒有好辦法。

-客觀原因：需求在變化，功能在變化，接口也在變化。所以，如果你寫了一個文件，它的自然更新和維護(hù)？天哪？

有解決方案嗎？建議嘗試：[1]swagger接口文檔，將文檔集成到代碼中，集成維護(hù)文檔和修改代碼，在修改代碼邏輯的同時方便修改文檔描述。

2、郵遞員界面測試工具，導(dǎo)入導(dǎo)出JSON文件，高效的團(tuán)隊合作。Postman支持各種請求方法和配置環(huán)境變量，對返回的結(jié)果進(jìn)行測試和驗證，支持批量自動操作，可與自動構(gòu)建系統(tǒng)集成。