http基礎(chǔ)分享

狀態(tài)碼:

200 OK - [GET]:服務(wù)器成功返回用戶請求的數(shù)據(jù)奠衔,該操作是冪等的(Idempotent)济赎。

201 CREATED - [POST/PUT/PATCH]:用戶新建或修改數(shù)據(jù)成功。

202 Accepted - [*]:表示一個(gè)請求已經(jīng)進(jìn)入后臺排隊(duì)(異步任務(wù))

204 NO CONTENT - [DELETE]:用戶刪除數(shù)據(jù)成功约巷。

400 INVALID REQUEST - [POST/PUT/PATCH]:用戶發(fā)出的請求有錯(cuò)誤偎痛,服務(wù)器沒有進(jìn)行新建或修改數(shù)據(jù)的操作,該操作是冪等的独郎。

401 Unauthorized - [*]:表示用戶沒有權(quán)限(令牌踩麦、用戶名枚赡、密碼錯(cuò)誤)。

403 Forbidden - [*] 表示用戶得到授權(quán)(與401錯(cuò)誤相對)谓谦,但是訪問是被禁止的贫橙。

404 NOT FOUND - [*]:用戶發(fā)出的請求針對的是不存在的記錄,服務(wù)器沒有進(jìn)行操作反粥,該操作是冪等的卢肃。

406 Not Acceptable - [GET]:用戶請求的格式不可得(比如用戶請求JSON格式,但是只有XML格式)才顿。

410 Gone -[GET]:用戶請求的資源被永久刪除莫湘,且不會再得到的。

422 Unprocesable entity - [POST/PUT/PATCH] 當(dāng)創(chuàng)建一個(gè)對象時(shí)娜膘,發(fā)生一個(gè)驗(yàn)證錯(cuò)誤逊脯。

500 INTERNAL SERVER ERROR - [*]:服務(wù)器發(fā)生錯(cuò)誤,用戶將無法判斷發(fā)出的請求是否成功竣贪。


動詞:

GET?/zoos:列出所有動物園

POST?/zoos:新建一個(gè)動物園

GET?/zoos/ID:獲取某個(gè)指定動物園的信息

PUT?/zoos/ID:更新某個(gè)指定動物園的信息(提供該動物園的全部信息)

PATCH?/zoos/ID:更新某個(gè)指定動物園的信息(提供該動物園的部分信息)

DELETE?/zoos/ID:刪除某個(gè)動物園

GET?/zoos/ID/animals:列出某個(gè)指定動物園的所有動物

DELETE?/zoos/ID/animals/ID:刪除某個(gè)指定動物園的指定動物


過濾信息:

如果記錄數(shù)量很多军洼,服務(wù)器不可能都將它們返回給用戶。API應(yīng)該提供參數(shù)演怎,過濾返回結(jié)果匕争。

下面是一些常見的參數(shù)。

?limit=10:指定返回記錄的數(shù)量

?offset=10:指定返回記錄的開始位置爷耀。

?page=2&per_page=100:指定第幾頁甘桑,以及每頁的記錄數(shù)。

?sortby=name&order=asc:指定返回結(jié)果按照哪個(gè)屬性排序歹叮,以及排序順序跑杭。

?animal_type_id=1:指定篩選條件

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個(gè)濱河市咆耿,隨后出現(xiàn)的幾起案子德谅,更是在濱河造成了極大的恐慌,老刑警劉巖萨螺,帶你破解...
    沈念sama閱讀 219,110評論 6 508
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件窄做,死亡現(xiàn)場離奇詭異,居然都是意外死亡慰技,警方通過查閱死者的電腦和手機(jī)椭盏,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 93,443評論 3 395
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來吻商,“玉大人掏颊,你說我怎么就攤上這事“剩” “怎么了乌叶?”我有些...
    開封第一講書人閱讀 165,474評論 0 356
  • 文/不壞的土叔 我叫張陵改化,是天一觀的道長。 經(jīng)常有香客問我枉昏,道長,這世上最難降的妖魔是什么揍鸟? 我笑而不...
    開封第一講書人閱讀 58,881評論 1 295
  • 正文 為了忘掉前任兄裂,我火速辦了婚禮,結(jié)果婚禮上阳藻,老公的妹妹穿的比我還像新娘晰奖。我一直安慰自己,他們只是感情好腥泥,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,902評論 6 392
  • 文/花漫 我一把揭開白布匾南。 她就那樣靜靜地躺著,像睡著了一般蛔外。 火紅的嫁衣襯著肌膚如雪蛆楞。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 51,698評論 1 305
  • 那天夹厌,我揣著相機(jī)與錄音豹爹,去河邊找鬼。 笑死矛纹,一個(gè)胖子當(dāng)著我的面吹牛臂聋,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播或南,決...
    沈念sama閱讀 40,418評論 3 419
  • 文/蒼蘭香墨 我猛地睜開眼孩等,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了采够?” 一聲冷哼從身側(cè)響起肄方,我...
    開封第一講書人閱讀 39,332評論 0 276
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎吁恍,沒想到半個(gè)月后扒秸,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 45,796評論 1 316
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡冀瓦,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,968評論 3 337
  • 正文 我和宋清朗相戀三年伴奥,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片翼闽。...
    茶點(diǎn)故事閱讀 40,110評論 1 351
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡拾徙,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出感局,到底是詐尸還是另有隱情尼啡,我是刑警寧澤暂衡,帶...
    沈念sama閱讀 35,792評論 5 346
  • 正文 年R本政府宣布,位于F島的核電站崖瞭,受9級特大地震影響狂巢,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜书聚,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,455評論 3 331
  • 文/蒙蒙 一唧领、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧雌续,春花似錦斩个、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 32,003評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至鸽心,卻和暖如春滚局,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背再悼。 一陣腳步聲響...
    開封第一講書人閱讀 33,130評論 1 272
  • 我被黑心中介騙來泰國打工核畴, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人冲九。 一個(gè)月前我還...
    沈念sama閱讀 48,348評論 3 373
  • 正文 我出身青樓谤草,卻偏偏與公主長得像,于是被迫代替她去往敵國和親莺奸。 傳聞我的和親對象是個(gè)殘疾皇子丑孩,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 45,047評論 2 355

推薦閱讀更多精彩內(nèi)容