① 娛樂圈311pdf是什麼
娛樂圈311是指網上有人寫了311頁的pdf文檔。
這文檔是一些明星的黑料內幕,也可以理解為311頁明星八卦合集。涵蓋了整個娛樂圈八卦內容匯總,相當於一篇長篇論文的內容。其中就包返仔含了漏搜汪四旦雙冰記、老傢伙系列、老花系列、小花系列、港澳台男明漏行星系列、港澳台女明星系列、老生系列、小生系列、慣三系列、子不語怪力亂神系列等等。
② 程序員怎樣規范編寫介面文檔
規范的事情當然要有專業的工具。推薦使用的是docway寫介面文檔,方便保存和共享,支持導出PDF MARKDOWN,支持團隊項目管理。
一些剛開始寫介面文檔的服務端同學,很容易按著代碼的思路去編寫介面文檔,這讓客戶端同學或者是服務對接方技術人員經常吐槽,看不懂介面文檔。這篇文章提供一個常規介面文檔的編寫方法,給大家參考。
一、請求參數
1. 請求方法
GET
用於獲取數據
POST
用於更新數據,可與PUT互換,語義上PUT支持冪等
PUT
用於新增數據,可與POST互換,語義上PUT支持冪等
DELETE
用於刪除數據
其他
其他的請求方法在一般的介面中很少使用。如:PATCH HEAD OPTIONS
2. URL
url表示了介面的請求路徑。路徑中可以包含參數,稱為地址參數,如**/user/{id}**,其中id作為一個參數。
3. HTTP Header
HTTP Header用於此次請求的基礎信息,在介面文檔中以K-V方式展示,其中Content-Type則是一個非常必要的header,它描述的請求體的數據類型。
常用的content-type:
application/x-www-form-urlencoded
請求參數使用「&」符號連接。
application/json
內容為json格式
application/xml
內容為xml格式
multipart/form-data
內容為多個數據組成,有分隔符隔開
4. HTTP Body
描述http body,依賴於body中具體的數據類型。如果body中的數據是對象類型。則需要描述對象中欄位的名稱、類型、長度、不能為空、默認值、說明。以表格的方式來表達最好。
示例:
五、介面工具
推薦使用的是http://docway.net(以前叫小幺雞) 寫介面文檔,方便保存和共享,支持導出PDF MARKDOWN,支持團隊項目管理。