什么是API添吗?
我們只要是在進行編程我們就需要不停的設(shè)計API沥曹。
API簡單來講可以是一個調(diào)用的函數(shù),一個接口碟联。
抽象來說妓美,接口是一個內(nèi)聚系統(tǒng)暴漏給外部的一切信息,包含但不限于:
調(diào)用方式:比如通過lib庫或者http接口等鲤孵。
調(diào)用約定:比如lib的函數(shù)簽名或者HTTP的參數(shù)壶栋,http method或者頭信息,長短鏈接等等普监。
依賴關(guān)系:比如接口的調(diào)用需要涉及到第三方或者其他的準備工作等等贵试。
API就像一個人一樣,我們和一個API打交道的時候需要了解這個人的特性偏好等凯正,有的人很好相處毙玻,而有的人讓人很頭疼,尤其是你不得不和他打交道的時候漆际,和人一樣,如果你不得不和他打交道夺饲,要改變他的秉性是很痛苦的奸汇,人的“本性難移”, API也一樣,一旦發(fā)布了往声,要改變的成本就很大很大擂找。
易于學習:即使沒有文檔也易于使用。
不易誤用:這一點很重要浩销,要減少使用者的心智負擔贯涎。
易于滿足需求:API的完備性和正交性。能夠容易的滿足需求慢洋,完備性保證功能完整塘雳,正交性保證接口的簡潔性陆盘,不需要為所有的需求提供接口,而是由用戶去組合败明。
易于擴展性
專一:一個API的功能應(yīng)該是單一的,需要能夠很容易的解釋和理解妻顶,也就會更好用酸员。
盡可能的小:小有很多的優(yōu)勢讳嘱,易于理解和維護幔嗦。
盡量少的外部依賴:減少使用者的成本。
設(shè)計不被實現(xiàn)影響:不要暴漏實現(xiàn)細節(jié)給用戶沥潭,竟可能少的暴露邀泉,不止是內(nèi)部細節(jié),對于不必要的接口盡量不要發(fā)布叛氨,比如使用不多的功能呼渣,可以暫時不暴露接口。
良好的命名:盡量做到自描述寞埠。
完善的文檔
考慮性能
如果你覺得眼前需要更好的提高你可以來千鋒學PHP屁置,國內(nèi)最好的PHP機構(gòu)。