發(fā)表日期:2019-02 文章編輯:小燈 瀏覽次數(shù):4350
為了開(kāi)始使用SiteServer REST API,我們將分解一些與API相關(guān)的關(guān)鍵概念和術(shù)語(yǔ):
RESTful
URL
請(qǐng)求
響應(yīng)
這些概念在使用和理解SiteServer REST API方面都扮演著重要的角色。讓我們簡(jiǎn)單地把它們分解一下,以便以后我們可以更深入地探討它們。
SiteServer REST API采用RESTful 作為API標(biāo)準(zhǔn),其具體實(shí)現(xiàn)遵循四個(gè)基本設(shè)計(jì)原則:
顯式地使用 HTTP 方法(GET、PUT、POST 、DELETE)。
無(wú)狀態(tài)。
公開(kāi)目錄結(jié)構(gòu)式的 URI。
傳輸 JavaScript Object Notation (JSON)。
URL是訪問(wèn)API的最終地址,URL由域名 + api + 版本 + 路徑
組成,訪問(wèn)不同的URL將獲取或修改不同的數(shù)據(jù)。
例如,通過(guò)URL http://example.com/api/v1/stl/sites 可以獲取到站點(diǎn)的列表,其中域名為 http://example.com/ ,版本為v1,路徑為/stl/sites。
URL可以帶參數(shù),例如,通過(guò)URL http://example.com/api/v1/stl/channels?siteId=1 可以獲取到站點(diǎn)Id為1的欄目的列表。
可以向 SiteServer REST API發(fā)起GET, POST, PUT, 以及 DELETE 四種不同的請(qǐng)求,每種請(qǐng)求的含義如下:
功能 | 類(lèi)型 |
---|---|
讀取 | GET |
創(chuàng)建 | POST |
更新 | PUT |
刪除 | DELETE |
請(qǐng)求就像是動(dòng)詞,而URL就像是名詞,把兩者相關(guān)聯(lián)就形成了對(duì)行為的邏輯表達(dá) — 例如, GET 這個(gè)記錄,DELETE 那條記錄。
響應(yīng)是你從REST API返回的數(shù)據(jù),響應(yīng)可以返回所需的數(shù)據(jù),也可以用來(lái)返回錯(cuò)誤。
日期:2019-02 瀏覽次數(shù):4349
日期:2019-02 瀏覽次數(shù):4180
日期:2019-02 瀏覽次數(shù):4302
日期:2019-02 瀏覽次數(shù):4497
日期:2019-02 瀏覽次數(shù):4704
Copyright ? 2013-2018 Tadeng NetWork Technology Co., LTD. All Rights Reserved.