http服務(wù)接口怎么設(shè)計(jì)？如果是提供給客戶端遠(yuǎn)程調(diào)用的API，可以參考下以下的最佳接口開(kāi)發(fā)實(shí)踐。(1)接口風(fēng)格和協(xié)議的選擇 - HTTP(2)接口域名 - 使用api單獨(dú)域名(3)異常處理 - 200

http服務(wù)接口怎么設(shè)計(jì)？

如果是提供給客戶端遠(yuǎn)程調(diào)用的API，可以參考下以下的最佳接口開(kāi)發(fā)實(shí)踐。

(1)接口風(fēng)格和協(xié)議的選擇 - HTTP

(2)接口域名 - 使用api單獨(dú)域名

(3)異常處理 - 200/400/500三大接口結(jié)果狀態(tài)碼

(4)對(duì)外的命名規(guī)則 - 使用小寫加下劃線

(5)對(duì)內(nèi)的命名規(guī)則 - 使用駝峰法和遵循PEAR命名

(6)安全與驗(yàn)證 - 使用接口簽名和token登錄態(tài)雙重機(jī)制

(7)返回結(jié)果格式 - JSON

(8)URL規(guī)則與路由映射 - 統(tǒng)一service接口服務(wù)，可一個(gè)文件一個(gè)接口

(9)SDK包 - 給客戶端自由的調(diào)用空間和自由

(10)接口文檔 - 使用markdown快速編寫

(11)測(cè)試驅(qū)動(dòng)開(kāi)發(fā) - 堅(jiān)持單元測(cè)試

追到一個(gè)心儀的女生不難，難于如何保持和培養(yǎng)一份真摯的感情；獲得一時(shí)的財(cái)富也不難，難于如何長(zhǎng)久保持收益；創(chuàng)業(yè)的公司很容易博得一時(shí)媒體的關(guān)注以及某次天使的投資，但難于如何排除各種障礙、充分利用各方資源發(fā)展成中企業(yè)及至上市公司。

同樣，提供一時(shí)的接口很容易，但當(dāng)我們需要不斷為接口提供升級(jí)，以及當(dāng)我們維護(hù)提供一整套接口時(shí)，面臨的困難和問(wèn)題會(huì)越來(lái)越大。

所以，這是一場(chǎng)持久的戰(zhàn)役。需要我們用穩(wěn)重的心態(tài)、專業(yè)的能力在背后持久支撐、推動(dòng)。

目前，后臺(tái)接口開(kāi)發(fā)可以用RESTFull風(fēng)格，也可以用Web Service；可以用SOAP協(xié)議、RPC協(xié)議，也可以用HTTP協(xié)議；可以用短鏈接，也可以使用長(zhǎng)鏈接。如果我們希望繼續(xù)進(jìn)行劃分，還可以分為同步或異步、單個(gè)或批量、是否有SDK包、內(nèi)部接口還是開(kāi)放接口平臺(tái)等。

現(xiàn)在看來(lái)，大部分大型的企業(yè)以及大多數(shù)的小公司使用的都是HTTP協(xié)議下的接口開(kāi)發(fā)，部分使用RESTFull，但Web Service較少。

這部分內(nèi)容可能比較老了，但我覺(jué)得還有參考價(jià)值的，更多可以查看：PhalApi(π框架) - PHP輕量級(jí)開(kāi)源接口框架 - 接口，從簡(jiǎn)單開(kāi)始！

phpsdk怎么開(kāi)始開(kāi)發(fā)？

你有自己的網(wǎng)站，想開(kāi)發(fā)一個(gè)php的sdk，然后開(kāi)放出去給別人調(diào)用。

你已經(jīng)下載了別人的sdk，然后想基于該sdk開(kāi)發(fā)自己的應(yīng)用。

第一種情況，無(wú)非是寫一些開(kāi)放接口，讓別人可以對(duì)你網(wǎng)站進(jìn)行有限的讀寫操作。

第二種情況很常見(jiàn)。最常見(jiàn)的就是我們下載微博的sdk，然后開(kāi)發(fā)自己的應(yīng)用。如果是這樣，你可以多參考sdk的wiki頁(yè)面，上面一般都有實(shí)例代碼。 最外層包含：配置文件， 鑒權(quán)和一些公共的函數(shù)。

HTTP 目錄主要包含了一些對(duì) http 進(jìn)行封裝的類，這塊你可以不用關(guān)心。

Storage 目錄主要包含兩大塊：Bucket 中文件的管理和文件的上傳。

Processing 目錄主要包含文件的處理，文件處理又包含兩個(gè)方面：同步處理和異步處理。

Cdn 目錄主要包含了 CDN 的相關(guān) API ，有文件的刷新和預(yù)取，CDN 日志的下載等方法。