成人无码视频,亚洲精品久久久久av无码,午夜精品久久久久久毛片,亚洲 中文字幕 日韩 无码

資訊專欄INFORMATION COLUMN

RESTful API的理解

willin / 617人閱讀

摘要：它的理論比較抽象不太具體，理解它主要在于理解這些概念資源表現(xiàn)層狀態(tài)轉(zhuǎn)換?；谠瓌t設(shè)計(jì)的，一般稱為，需要遵守以下這些原則。返回結(jié)果，結(jié)果應(yīng)該包括多種情況，異常錯(cuò)誤信息正確結(jié)果目前而言最好使用格式傳輸數(shù)據(jù)。參考的理解，阮一峰

RESTful API

目前的異步加載橫行的時(shí)候，異步請(qǐng)求已經(jīng)遍地都是，而規(guī)定請(qǐng)求接口的時(shí)候，如果不能有很好的風(fēng)格的話，很多時(shí)候會(huì)讓開發(fā)者誤解，一個(gè)好的API接口 設(shè)計(jì)需要注意以下：

參數(shù)職責(zé)單一

意圖清晰，便于開發(fā)者調(diào)用

易于訪問者輸入

看是但是真的設(shè)計(jì)的時(shí)候經(jīng)常會(huì)設(shè)計(jì)出不規(guī)范 的接口，

REST原則

REST 即Representational State Transfer的縮寫。它的理論比較抽象不太具體，理解它主要在于理解這些概念：資源、表現(xiàn)層、狀態(tài)轉(zhuǎn)換。
基于REST原則設(shè)計(jì)的API，一般稱為 RESTFul API，需要遵守以下這些原則。

URL描述的是一個(gè)特定資源。因此描述需要名詞，不能出現(xiàn)動(dòng)詞。因?yàn)閯?dòng)詞描述的不再是資源本身，而是行為

利用HTTP請(qǐng)求的動(dòng)詞表示對(duì)于資源操作的行為

同時(shí)，對(duì)于URL的設(shè)計(jì)一般還有約定俗成的以下補(bǔ)充。

對(duì)于資源的描述的名詞應(yīng)該是層級(jí)嵌套的方式，比如 /company/department/projects。通過這種對(duì)于信息層級(jí)描述的方式，更利于實(shí)體的抽象，以及增加客戶端與服務(wù)器端開發(fā)人員對(duì)于整個(gè)系統(tǒng)模塊認(rèn)知的一致性

路徑終點(diǎn)的命名考慮用復(fù)數(shù)形式，比如 /books。一般一個(gè)URL路徑表示的資源會(huì)映射為數(shù)據(jù)庫一系列表的記錄的集合，因此使用復(fù)數(shù)更直觀

實(shí)踐設(shè)計(jì)

實(shí)際設(shè)計(jì)restful api時(shí)的注意點(diǎn)包括以下：

盡量使用https協(xié)議

如果接口是公用且會(huì)被擴(kuò)展時(shí)，應(yīng)該考慮放在專有域名下，https://api.baidu.com

由于api會(huì)在業(yè)務(wù)中不斷地迭代，所以最好是帶上版本，https://api.baidu.com/v2/

最后接口路徑應(yīng)該盡量使用集合，也就是復(fù)數(shù)形式，https://api.baidu.com/v2/books

操作類接口應(yīng)該注意使用對(duì)應(yīng)的動(dòng)詞來操作

GET /zoos：列出所有動(dòng)物園
POST /zoos：新建一個(gè)動(dòng)物園
GET /zoos/ID：獲取某個(gè)指定動(dòng)物園的信息
PUT /zoos/ID：更新某個(gè)指定動(dòng)物園的信息（提供該動(dòng)物園的全部信息）
PATCH /zoos/ID：更新某個(gè)指定動(dòng)物園的信息（提供該動(dòng)物園的部分信息）
DELETE /zoos/ID：刪除某個(gè)動(dòng)物園
GET /zoos/ID/animals：列出某個(gè)指定動(dòng)物園的所有動(dòng)物
DELETE /zoos/ID/animals/ID：刪除某個(gè)指定動(dòng)物園的指定動(dòng)物

參數(shù)，使用參數(shù)來進(jìn)行篩選，?page=2&per_page=100：指定第幾頁，以及每頁的記錄數(shù)。

返回結(jié)果，結(jié)果應(yīng)該包括多種情況，異常、錯(cuò)誤信息、正確結(jié)果{status:"ok",massage:"ok",data:{data:1}}

目前而言最好使用JSON格式傳輸數(shù)據(jù)。

參考：efe的restful理解，阮一峰restful api

文章版權(quán)歸作者所有，未經(jīng)允許請(qǐng)勿轉(zhuǎn)載,若此文章存在違規(guī)行為，您可以聯(lián)系管理員刪除。

轉(zhuǎn)載請(qǐng)注明本文地址：http://m.hztianpu.com/yun/89288.html

相關(guān)文章

  • 理解 RESTful

    摘要：表形容詞，意為的具有的。指的是一組架構(gòu)約束條件和原則。協(xié)議要優(yōu)于協(xié)議。的操作方法在中有各自的語義，理解它們的語義至為重要。返回結(jié)果對(duì)于不同操作方法和操作對(duì)象集合或個(gè)體，服務(wù)器返回的結(jié)果應(yīng)該符合以下規(guī)范。附錄該文主要參考理解架構(gòu)設(shè)計(jì)指南 前言 近十年，前端高速發(fā)展，整個(gè)互聯(lián)網(wǎng)應(yīng)用經(jīng)歷了從輕客戶端到重客戶端的變化，隨著前端規(guī)模越來越大，交互越來越復(fù)雜，前后端分離的設(shè)計(jì)開始流行。 移動(dòng)互聯(lián)網(wǎng)...

    MkkHou 評(píng)論0 收藏0

  • 理解 RESTful

    摘要：表形容詞，意為的具有的。指的是一組架構(gòu)約束條件和原則。協(xié)議要優(yōu)于協(xié)議。的操作方法在中有各自的語義，理解它們的語義至為重要。返回結(jié)果對(duì)于不同操作方法和操作對(duì)象集合或個(gè)體，服務(wù)器返回的結(jié)果應(yīng)該符合以下規(guī)范。附錄該文主要參考理解架構(gòu)設(shè)計(jì)指南 前言 近十年，前端高速發(fā)展，整個(gè)互聯(lián)網(wǎng)應(yīng)用經(jīng)歷了從輕客戶端到重客戶端的變化，隨著前端規(guī)模越來越大，交互越來越復(fù)雜，前后端分離的設(shè)計(jì)開始流行。 移動(dòng)互聯(lián)網(wǎng)...

    Drummor 評(píng)論0 收藏0

  • PHP / Laravel API 開發(fā)推薦閱讀清單

    showImg(https://segmentfault.com/img/bV6aHV?w=1280&h=800); 社區(qū)優(yōu)秀文章 Laravel 5.5+passport 放棄 dingo 開發(fā) API 實(shí)戰(zhàn)，讓 API 開發(fā)更省心 - 自造車輪。 API 文檔神器 Swagger 介紹及在 PHP 項(xiàng)目中使用 - API 文檔撰寫方案 推薦 Laravel API 項(xiàng)目必須使用的 8 個(gè)...

    shmily 評(píng)論0 收藏0

  • RESTful實(shí)踐（具體應(yīng)用）思考

    摘要：其他交互一般會(huì)遵循一些數(shù)據(jù)結(jié)構(gòu)協(xié)議或者狀態(tài)值，比如不同的操作結(jié)果對(duì)應(yīng)不同的狀態(tài)值，且出錯(cuò)會(huì)返回指定的錯(cuò)誤信息方便前端進(jìn)行提示等。 RESTful這種架構(gòu)已經(jīng)具有很長(zhǎng)的時(shí)間和歷程了，但似乎最近restful這個(gè)詞出現(xiàn)的頻率特別高，目前不是很清楚是因?yàn)槲易詡€(gè)兒現(xiàn)在是以restful風(fēng)格寫程序產(chǎn)生的孕婦效應(yīng)，還是單頁面程序開發(fā)的流行造成的。 其實(shí)一開始我也是不想寫這篇文章的，因?yàn)榫W(wǎng)絡(luò)上與re...

    myshell 評(píng)論0 收藏0

  • 關(guān)于RESTful API 設(shè)計(jì)的總結(jié)

    摘要：互聯(lián)網(wǎng)通信協(xié)議協(xié)議，是一個(gè)無狀態(tài)協(xié)議。具體來說，就是協(xié)議里面，四個(gè)表示操作方式的動(dòng)詞。版本號(hào)的版本號(hào)和客戶端的版本號(hào)是毫無關(guān)系的，不要讓將它們用于提交應(yīng)用市場(chǎng)的版本號(hào)傳遞到服務(wù)器，而是提供類似于之類的版本號(hào)。版本號(hào)拼接在中。 為什么要用 RESTful RESTful 給我的最大感覺就是規(guī)范、易懂和優(yōu)雅，一個(gè)結(jié)構(gòu)清晰、易于理解的 API 完全可以省去許多無意義的溝通和文檔。并且 RES...

    andong777 評(píng)論0 收藏0

發(fā)表評(píng)論

0條評(píng)論

閱讀需要支付1元查看
<