1,協議
API和用戶之間的通信協議總是使用HTTPs協議。
2.域名
您應該嘗試在私有域名下部署API。
如果妳確定API比較簡單,不會進壹步擴展,可以考慮放在主域名下。
3.版本控制
您應該將API的版本號放在URL中。
另壹種方式是將版本號放在HTTP頭信息中,但不如放URL方便直觀。Github采用了這種方法。
4、路徑(端點)
路徑,也叫“端點”,表示API的具體URL。
在RESTful架構中,每個URL代表壹個資源,所以URL中不能有動詞,只能有名詞,而且使用的名詞往往對應數據庫的表名。壹般來說,數據庫中的表都是同類記錄的“集合”,所以API中的名詞也應該是復數。
例如,如果有壹個API提供關於動物園的信息,包括各種動物和員工的信息,那麽它的路徑應該設計如下。