2.API模塊化
將大型問題轉化為規模較小的、可單獨解決的問題。模塊化API更容易學習，並且可以隨時間而改變。你可以用新模塊替代舊模塊，可以一個一個地教導模塊，也可以將API的實驗部分從穩定或傳統的部分中單獨分出來。

3.使用結構化語法
使用結構化的API語法：用thing.action或thing.property代替do_action_with_thing。語法將自然而然地適應模塊化的方法，其中每個模塊是一個類。

4.使用自然語義
不要發明新概念，只使用開發人員眾所周知的概念，作為類系系統的基礎。如果你發現自己需要解釋概念，那說明你出錯了：要麽你在解決以後的問題，要麽你正在錯誤地構建API。

5.API的自我約定
每個類都要嚴格使用相同的樣式和約定，一致性是指當一個人學會這一個類時，他就能夠融會貫通地掌握全部的類。文檔化約定，讓它們成為貢獻者必須的標準。

6.API的可擴展性
易擴展性有許多好處，並不僅僅在於受到貢獻者的歡迎。它還可以讓你延緩實現功能，因為“如果需要的話，後面再添加也很方便”。不需要的功能就不添加，這也是一種雙贏。

7.完全測試
每個類和方法必須經過惡意代碼的完全測試，要像寫代碼一樣寫測試，然後像API提供給外界約定文檔一樣使用測試。每當代碼改變的時候就運行這些測試。不要擔心代碼覆蓋率。重要的是外部約定。也可以考慮使用約定生命周期。

8.分層式成長
保持API突出重點，然後在頂部將新的API分層，以便於它們能隨著時間的推移成長。可擴展性並不意味著無限期的成長。明確API的範圍，並在範圍內執行。

9.保持簡單易用
最終的測試要看API的簡單易用程度。你寫的例子，能不能讓你的代碼看起來更簡單？你是不是強迫用戶說明他們不在乎的選項？有沒有毫無價值的額外步驟？要註重約減少API的可視面積。

10.保持可移植性
不要讓系統概念泄漏到API。整潔有目的地抽象：這個API可以運行在任何操作系統上。API必須能夠隱藏實現，但要註意第4條規則，以及要使用自然抽象。

PHP彩票源碼論壇 API設計的十大原則