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