如果是提供給客戶端遠端呼叫的API，可以參考下以下的最佳介面開發實踐。

(1)介面風格和協議的選擇 - HTTP(2)介面域名 - 使用api單獨域名(3)異常處理 - 200/400/500三大介面結果狀態碼(4)對外的命名規則 - 使用小寫加下劃線(5)對內的命名規則 - 使用駝峰法和遵循PEAR命名(6)安全與驗證 - 使用介面簽名和token登入態雙重機制(7)返回結果格式 - JSON(8)URL規則與路由對映 - 統一service介面服務，可一個檔案一個介面(9)SDK包 - 給客戶端自由的呼叫空間和自由(10)介面文件 - 使用markdown快速編寫(11)測試驅動開發 - 堅持單元測試

追到一個心儀的女生不難，難於如何保持和培養一份真摯的感情；獲得一時的財富也不難，難於如何長久保持收益；創業的公司很容易博得一時媒體的關注以及某次天使的投資，但難於如何排除各種障礙、充分利用各方資源發展成中企業及至上市公司。

同樣，提供一時的介面很容易，但當我們需要不斷為介面提供升級，以及當我們維護提供一整套介面時，面臨的困難和問題會越來越大。所以，這是一場持久的戰役。需要我們用穩重的心態、專業的能力在背後持久支撐、推動。

目前，後臺介面開發可以用RESTFull風格，也可以用Web Service；可以用SOAP協議、RPC協議，也可以用HTTP協議；可以用短連結，也可以使用長連結。如果我們希望繼續進行劃分，還可以分為同步或非同步、單個或批次、是否有SDK包、內部介面還是開放介面平臺等。

現在看來，大部分大型的企業以及大多數的小公司使用的都是HTTP協議下的介面開發，部分使用RESTFull，但Web Service較少。

這部分內容可能比較老了，但我覺得還有參考價值的，更多可以檢視：PhalApi(π框架) - PHP輕量級開源介面框架 - 介面，從簡單開始！