多年的IT經驗告訴你：不合理，而且會造成工期的延誤，不利于整體項目的推進。

接口

它是基于超文本傳輸協議（HTTP）之上而確定的一組約束和屬性，是一種設計提供萬維網絡服務的軟件構建風格。

符合或兼容于這種架構風格的網絡服務，允許客戶端發出以統一資源標識符訪問和操作網絡資源的請求，而與預先定義好的無狀態操作集一致化。

接口文檔

在項目開發中，web項目的前后端分離開發源碼，APP開發，需要由前后端工程師共同定義接口，編寫接口文檔，之后大家都根據這個接口文檔進行開發，到項目結束前都要一直維護。

為啥要提前提供接口規范文檔

因為項目初期，需求確定后就要進行開發。而在開發過程中，都是團隊協作。每個人不是孤軍奮戰，尤其在前后端分離的項目電銷外呼程序上接口規范文檔尤其重要。

這里簡單說下一個概念：前后端分離，就是前臺負責做頁面，調用后臺的接口服務獲取數據，然后渲染頁面，呈現給用戶。后端需要提供接口能力，保證功能穩定性。

在實際過程，前端開發設計需要時間，而后端開發接口也同樣需要時間，所以先提供接口規范有利于前端根據接口規范，模擬返回數據源碼，進行模擬測試。而后臺在這段時間也可以開發接口服務，等到按照預期的聯調時間，就可以前后臺進行正式聯調。

為啥需要正式聯調，因為接口規范可能會在實際開發過程中發生變動，前端第一次根據后臺的接口規范構造的模擬數據，不足以證明后期的實際聯調沒問題。

在正式聯調后，確定最終的接口規范文檔，對外發布。

合格的接口規范文檔

明確定義接口的名字、作用。這樣有利于讀者對接口所涉及的業務功能有清晰的概念。定義接口的URL地址。定義接口的請求方式，如GET請求、POST請求。定義接口請求的Header頭部信息，比如定義"Content-Type": "application/json;charset=UTF-8"。定義接口的參數字段名、字段類型、是否必填、說明字段的意義、備注（可選）。定義接口返回的狀態碼，比如常見的200 OK。定義接口返回的的Header頭部信息。定義接口返回的響應結果。（可選）提供接口返回的請求例子、響應結果例子。

團隊合作，文檔先行，編碼在后，這樣有利于整體項目如期完成。

希望該回答，可以幫助到你。