Q
程序報告里的接口清單怎么排才方便下游直接對接？
A
按調用頻次從高到低排，每條接口頂格寫路徑，下面縮進兩格寫請求方法、必填參數、返回成功結構體字段名。失敗返回只寫HTTP狀態碼+一句話原因，不寫錯誤碼表。字段名用代碼里真實變量名，不翻譯成中文。參數類型寫string/int/bool，不寫“字符串類型”。
高分寫作經驗
熱門篇幅區間
推薦寫法
數據顯示，有38.8%的用戶認為，首選的寫法是字段名嚴格同步代碼，43.2%%的用戶傾向選擇3500-4500字，而30.4%%的用戶選擇2800-3400字，18.8%%選擇4600-5200字。新手最容易踩的坑是接口按字母順序排，參數寫“用戶信息對象”，返回示例用虛構JSON，字段名和代碼里對不上。
適用對象
聯調中的前端、做自動化測試的QA、接API的第三方、寫SDK的同事
新手常犯的誤區
接口按字母順序排，參數寫“用戶信息對象”，返回示例用虛構JSON，字段名和代碼里對不上。
