- 請求方式有很多,但是由于為了統(tǒng)一,所以目前所有的接口的定義都定義成為了POST方式,這樣雖然不完全遵守restful的定義,但是也有一些好處。
- 可以對參數(shù)進(jìn)行一定的保護(hù)
- 可以避免超出
GET請求參數(shù)長度限制 - 接口定義都是盡量都是由一個單詞組成,如果出現(xiàn)多個單詞的情況下,通過中劃線
-來進(jìn)行分割。不使用Java的駝峰命名法。 - 接口業(yè)務(wù)參數(shù)如果是簡單類型,并且數(shù)量少于3個,則使用
application/x-www-form-urlencoded方式進(jìn)行接受。如果是復(fù)雜對象類型,那么就使用application/json放手進(jìn)行接受。 - 一些公共參數(shù)比如
設(shè)備號、版本號、ip等都放到HTTP的Header里面,不要和業(yè)務(wù)接口參數(shù)混到一起。
公共請求參數(shù)總結(jié)
- 設(shè)備id
- 用戶憑證
- 終端類型id
- 基礎(chǔ)信息(平臺|系統(tǒng)版本|渠道|版本號|機(jī)型|網(wǎng)絡(luò)類型)
- 請求唯一標(biāo)志(traceid|spanid)
- 地理信息 (經(jīng)度|緯度)
- 客戶端時間
- 接口所在頁面名稱