以我的經歷來說(經過三個案子)，結案前通常都要完成規格書，裡面就會包含你說的那些，每一項都要寫得清楚並加上備註，現在第四個案子了覺得是後端人員該做的，因為只有自己最懂自己寫的用途與使用方法~
感謝後端是誰講的= =
你寫API沒寫規格
鬼才知道要怎麼call server
有遇過團隊是只告訴你 api需要的 request 資料，但回傳的 response 跟裡面代表意思都沒給
那只能勸你快逃了，工程師也是有程度之分的。
所以是要靠擲筊知道response的含意嗎?還是說理解錯誤要怪自己理解能力差。
還有和遇到的"人(垃圾)"有關係，公司同事遇過(對方是API端)開發前已討論好A介接格式，開發好測試時才知變成B介接格式，開發好測試完成上正式機時變成C介接格式，只因為A=>B沒有通知我們，我們向甲方反應而已，所以"人"很重要。
可能要通靈才能知道response含義，但如果真的不清楚的話，還是可以問後端的
wuewen目前經驗來看，API需求變來變去好像挺正常的?你這邊講述的例子，我還真遇過，然後事後就會跟你說，你們前端改一下應該不會很久吧...
janlin002我們這件事，是在開發中對方單方面變更介接格式時，就有跟對方說，若有變更的話要請事先通知，可是等到上正式機時，又在未通知的情況下變更為C格式，當然主要是之前在溝通的過程中就交惡了，所以對方其實是故意的，因為已經要上線了，變成要在很趕的時間內完成，且而對方還故意不提供介接文件。
另外，API變來變去我們很少遇到，都是開發前討論好了，就確定了，除非在實作的過程中發現有先前沒想到的，才會變更。因為一般人不會在需求未變更的前提下，突然改來改去。
不是已經有類似open api Swagger文檔了嗎?
後端工程師可能就是透過註解一些資訊就好了
https://coolmandiary.blogspot.com/2021/12/net-core-web-api21swaggeropenapiapi.html
https://coolmandiary.blogspot.com/2022/01/net-core-web-api22swagger.html
iThome鐵人賽
看影片追技術