怎么使用php調(diào)用api接口 http服務(wù)接口怎么設(shè)計(jì)?
http服務(wù)接口怎么設(shè)計(jì)?如果是提供給客戶端遠(yuǎn)程調(diào)用的API,可以參考下以下的最佳接口開發(fā)實(shí)踐。(1)接口風(fēng)格和協(xié)議的選擇 - HTTP(2)接口域名 - 使用api單獨(dú)域名(3)異常處理 - 200
http服務(wù)接口怎么設(shè)計(jì)?
如果是提供給客戶端遠(yuǎn)程調(diào)用的API,可以參考下以下的最佳接口開發(fā)實(shí)踐。
(1)接口風(fēng)格和協(xié)議的選擇 - HTTP
(2)接口域名 - 使用api單獨(dú)域名
(3)異常處理 - 200/400/500三大接口結(jié)果狀態(tài)碼
(4)對外的命名規(guī)則 - 使用小寫加下劃線
(5)對內(nèi)的命名規(guī)則 - 使用駝峰法和遵循PEAR命名
(6)安全與驗(yàn)證 - 使用接口簽名和token登錄態(tài)雙重機(jī)制
(7)返回結(jié)果格式 - JSON
(8)URL規(guī)則與路由映射 - 統(tǒng)一service接口服務(wù),可一個文件一個接口
(9)SDK包 - 給客戶端自由的調(diào)用空間和自由
(10)接口文檔 - 使用markdown快速編寫
(11)測試驅(qū)動開發(fā) - 堅(jiān)持單元測試
追到一個心儀的女生不難,難于如何保持和培養(yǎng)一份真摯的感情;獲得一時的財(cái)富也不難,難于如何長久保持收益;創(chuàng)業(yè)的公司很容易博得一時媒體的關(guān)注以及某次天使的投資,但難于如何排除各種障礙、充分利用各方資源發(fā)展成中企業(yè)及至上市公司。
同樣,提供一時的接口很容易,但當(dāng)我們需要不斷為接口提供升級,以及當(dāng)我們維護(hù)提供一整套接口時,面臨的困難和問題會越來越大。
所以,這是一場持久的戰(zhàn)役。需要我們用穩(wěn)重的心態(tài)、專業(yè)的能力在背后持久支撐、推動。
目前,后臺接口開發(fā)可以用RESTFull風(fēng)格,也可以用Web Service;可以用SOAP協(xié)議、RPC協(xié)議,也可以用HTTP協(xié)議;可以用短鏈接,也可以使用長鏈接。如果我們希望繼續(xù)進(jìn)行劃分,還可以分為同步或異步、單個或批量、是否有SDK包、內(nèi)部接口還是開放接口平臺等。
現(xiàn)在看來,大部分大型的企業(yè)以及大多數(shù)的小公司使用的都是HTTP協(xié)議下的接口開發(fā),部分使用RESTFull,但Web Service較少。
這部分內(nèi)容可能比較老了,但我覺得還有參考價(jià)值的,更多可以查看:PhalApi(π框架) - PHP輕量級開源接口框架 - 接口,從簡單開始!
phpsdk怎么開始開發(fā)?
你有自己的網(wǎng)站,想開發(fā)一個php的sdk,然后開放出去給別人調(diào)用。
你已經(jīng)下載了別人的sdk,然后想基于該sdk開發(fā)自己的應(yīng)用。
第一種情況,無非是寫一些開放接口,讓別人可以對你網(wǎng)站進(jìn)行有限的讀寫操作。
第二種情況很常見。最常見的就是我們下載微博的sdk,然后開發(fā)自己的應(yīng)用。如果是這樣,你可以多參考sdk的wiki頁面,上面一般都有實(shí)例代碼。 最外層包含:配置文件, 鑒權(quán)和一些公共的函數(shù)。
HTTP 目錄主要包含了一些對 http 進(jìn)行封裝的類,這塊你可以不用關(guān)心。
Storage 目錄主要包含兩大塊:Bucket 中文件的管理和文件的上傳。
Processing 目錄主要包含文件的處理,文件處理又包含兩個方面:同步處理和異步處理。
Cdn 目錄主要包含了 CDN 的相關(guān) API ,有文件的刷新和預(yù)取,CDN 日志的下載等方法。