show me the code and talk to me,做的出來更要說的明白
我是布爾bl，你的支持是我分享的動力！

一 、引入

設計接口是我們開發人員的日常操作。當我們把接口交給前端人員時，是否有種拔劍出鞘的錯覺。畢竟交付接口，我們的開發工作就階段性完成了。不過，如果我們沒有一個接口設計規范的時候，結果會怎樣呢？我們來張圖感受一下。

二、REST

2000年，一個年輕小伙子（Roy Thomas Fielding）在他的博士論文提出了 REST。REST 是一種萬維網軟件架構風格。為什么說是風格不是標準呢？個人理解可能說標準就有點過分了。小伙子做不到。隨后這種風格被推廣開來，漂洋過海，被大眾熟知。在 REST 的基礎上，產生了 RESTFUL 。什么是 RESTFUL？簡單的說，符合 REST 風格的接口就是 RESTFUL。

三、RESTFUL

接口各種各樣。正如一千個人眼里有一千個魯迅。RESTFUL 接口究竟長什么樣子呢？

3.1 HTTP 的方法

HTTP 里面有幾個基本的方法。我們利用這些約定一些規范。

從表中，如果我們可以清楚看到當我們的接口是關于獲取數據，那么我們使用 GET 方法。
如果我們可以清楚看到當我們的接口是關于插入數據，那么我們使用 POST 方法。
如果我們可以清楚看到當我們的接口是關于更新數據，那么我們使用 PUT 方法。
如果我們可以清楚看到當我們的接口是關于刪除數據，那么我們使用 DELECT 方法。

3.2 名詞

在上面我們已經知道接口在什么時候需要什么方法，那么我們現在來進入到設計接口的第二步。

我們看看線上網站的接口是怎么樣的。

圖中我們可以看到有個 v1 ，他代表的是版本號，所以我們在設計接口的時候可以在將版本號寫上，用 v1、v2、v3 等表示。

我們發現他的接口都是名詞。所以我們知道 RESTFUL 接口使用的是名詞。比如我們設計一個獲取數據的接口，我們可這樣設計

/

上面接口是獲取所有數據。

當我們需要列表中的一條數據，我們可以這樣設計

/

上面接口表示獲取是列表的1號數據，我們可以獲取2號、3號數據等等，只要改變數字即可。

3.3 組合

結合上面兩步，我們就可以設計出增刪改查的 restful 接口了。

3.4 應用

以下是源碼的demo

import

四、某同城交友網站

https://github.com/buerbl

暗號：荊軻刺秦王

總結

以上是生活随笔為你收集整理的rest 接口怎么传list_如何设计一个优雅的RESTFUL的接口的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。