HTTP協(xié)議

HTTP協(xié)議描述

HTTP協(xié)議是Hyper Text Transfer Protocol（超文本傳輸協(xié)議）的縮寫,是用于從萬(wàn)維網(wǎng)（WWW:World Wide Web ）服務(wù)器傳輸超文本^[1]到本地瀏覽器的傳送協(xié)議兰绣。HTTP是一個(gè)基于TCP/IP通信協(xié)議來(lái)傳遞數(shù)據(jù)（HTML 文件, 圖片文件, 查詢結(jié)果等）。

通常，由HTTP客戶端發(fā)起一個(gè)請(qǐng)求，建立一個(gè)到服務(wù)器指定端口（默認(rèn)是80端口）的TCP連接链沼。HTTP服務(wù)器則在那個(gè)端口監(jiān)聽客戶端發(fā)送過(guò)來(lái)的請(qǐng)求晦毙。一旦收到請(qǐng)求，服務(wù)器（向客戶端）發(fā)回一個(gè)狀態(tài)行资厉，比如"HTTP/1.1 200 OK"王污，和（響應(yīng)的）消息罢吃，消息的消息體可能是請(qǐng)求的文件、錯(cuò)誤消息昭齐、或者其它一些信息刃麸。

HTTP是一個(gè)客戶端和服務(wù)器端請(qǐng)求和應(yīng)答的標(biāo)準(zhǔn)（TCP）∷纠耍客戶端是終端用戶，服務(wù)器端是網(wǎng)站把沼。通過(guò)使用Web瀏覽器啊易、網(wǎng)絡(luò)爬蟲或者其它工具的客戶端發(fā)起一個(gè)到服務(wù)器上指定端口（默認(rèn)端口為80）的HTTP請(qǐng)求，稱這個(gè)客戶端叫用戶代理（user agent）饮睬。

在Internet中所有的傳輸都是通過(guò)TCP/IP進(jìn)行的租谈。HTTP協(xié)議作為TCP/IP模型中應(yīng)用層的協(xié)議也不例外。HTTP協(xié)議通常承載于TCP協(xié)議之上捆愁，有時(shí)也承載于TLS或SSL協(xié)議層之上割去，這個(gè)時(shí)候，就成了我們常說(shuō)的HTTPS昼丑。
<center>

15215564008151.jpg -w400

</center>

HTTP默認(rèn)的端口號(hào)為80呻逆，HTTPS的端口號(hào)為443。

瀏覽網(wǎng)頁(yè)是HTTP的主要應(yīng)用菩帝，但是這并不代表HTTP就只能應(yīng)用于網(wǎng)頁(yè)的瀏覽咖城。HTTP是一種協(xié)議茬腿，只要通信的雙方都遵守這個(gè)協(xié)議，HTTP就能有用武之地宜雀。

HTTP特點(diǎn)

1. 無(wú)狀態(tài)：每次HTTP請(qǐng)求都是獨(dú)立的切平，任何兩個(gè)請(qǐng)求之間沒(méi)有什么必然的聯(lián)系。

   協(xié)議的狀態(tài)是指下一次傳輸可以“記住”這次傳輸信息的能力辐董。HTTP是不會(huì)為了下一次連接而維護(hù)這次連接所傳輸?shù)男畔?為了保證服務(wù)器內(nèi)存悴品。

2. 支持客戶/服務(wù)器模式。支持基本認(rèn)證和安全認(rèn)證简烘。

3. 簡(jiǎn)單快速：客戶向服務(wù)器請(qǐng)求服務(wù)時(shí)苔严，只需傳送請(qǐng)求方法和路徑。請(qǐng)求方法常用的有GET夸研、HEAD邦蜜、POST。每種方法規(guī)定了客戶與服務(wù)器聯(lián)系的類型不同亥至。由于HTTP協(xié)議簡(jiǎn)單悼沈，使得HTTP服務(wù)器的程序規(guī)模小，因而通信速度很快姐扮。

4. 靈活：HTTP允許傳輸任意類型的數(shù)據(jù)對(duì)象絮供。正在傳輸?shù)念愋陀蒀ontent-Type加以標(biāo)記。

5. HTTP 0.9和1.0使用非持續(xù)連接：限制每次連接只處理一個(gè)請(qǐng)求茶敏，服務(wù)器處理完客戶的請(qǐng)求壤靶，并收到客戶的應(yīng)答后，即斷開連接惊搏。HTTP 1.1使用持續(xù)連接：不必為每個(gè)web對(duì)象創(chuàng)建一個(gè)新的連接贮乳，一個(gè)連接可以傳送多個(gè)對(duì)象，采用這種方式可以節(jié)省傳輸時(shí)間恬惯。

HTTP工作流程

一次HTTP操作稱為一個(gè)事務(wù)向拆，其工作過(guò)程可分為四步：

1. 首先客戶機(jī)與服務(wù)器需要建立連接。只要單擊某個(gè)超級(jí)鏈接酪耳，HTTP的工作開始浓恳。
2. 建立連接后，客戶機(jī)發(fā)送一個(gè)請(qǐng)求給服務(wù)器碗暗，請(qǐng)求方式的格式為：統(tǒng)一資源標(biāo)識(shí)符（URL）颈将、協(xié)議版本號(hào)，后邊是MIME信息包括請(qǐng)求修飾符言疗、客戶機(jī)信息和可能的內(nèi)容晴圾。
3. 服務(wù)器接到請(qǐng)求后，給予相應(yīng)的響應(yīng)信息噪奄，其格式為一個(gè)狀態(tài)行疑务，包括信息的協(xié)議版本號(hào)沾凄、一個(gè)成功或錯(cuò)誤的代碼，后邊是MIME信息包括服務(wù)器信息知允、實(shí)體信息和可能的內(nèi)容撒蟀。
4. 客戶端接收服務(wù)器所返回的信息通過(guò)瀏覽器顯示在用戶的顯示屏上，然后客戶機(jī)與服務(wù)器斷開連接温鸽。

URI

URI（統(tǒng)一資源標(biāo)識(shí)符）^[2]：是一個(gè)用于標(biāo)識(shí)某一互聯(lián)網(wǎng)資源名稱的字符串保屯。而這個(gè)資源由兩個(gè)部分確定：資源地址信息（URL）+資源名稱信息（URN）;

常見的URI格式如下：
http://user:password@host.com:8080/p/a/t/h?query=string&action=add#has

HTTP請(qǐng)求與響應(yīng)

HTTP協(xié)議分為請(qǐng)求（Request）與響應(yīng)（Response）兩個(gè)部分涤垫。

Request——請(qǐng)求

請(qǐng)求內(nèi)容

請(qǐng)求信息內(nèi)容包括以下幾點(diǎn)：

• 請(qǐng)求行——request line

  • 請(qǐng)求方法：GET/POST/HEAD/DELETE/PUT/TRACE/OPTIONS姑尺。方法名稱是區(qū)分大小寫的。當(dāng)某個(gè)請(qǐng)求所針對(duì)的資源不支持對(duì)應(yīng)的請(qǐng)求方法的時(shí)候蝠猬，服務(wù)器應(yīng)當(dāng)返回狀態(tài)碼405（Method Not Allowed）切蟋；當(dāng)服務(wù)器不認(rèn)識(shí)或者不支持對(duì)應(yīng)的請(qǐng)求方法的時(shí)候，應(yīng)當(dāng)返回狀態(tài)碼501（Not Implemented）榆芦。HTTP服務(wù)器至少應(yīng)該實(shí)現(xiàn)GET和HEAD方法柄粹，其他方法都是可選的。此外匆绣，除了上述方法驻右，特定的HTTP服務(wù)器還能夠擴(kuò)展自定義的方法。

    請(qǐng)求方法	含義
    OPTIONS	返回服務(wù)器針對(duì)特定資源所支持的HTTP請(qǐng)求方法崎淳。也可以利用向Web服務(wù)器發(fā)送'*'的請(qǐng)求來(lái)測(cè)試服務(wù)器的功能性堪夭。
    HEAD	向服務(wù)器索要與GET請(qǐng)求相一致的響應(yīng)，只不過(guò)響應(yīng)體將不會(huì)被返回拣凹。這一方法可以在不必傳輸整個(gè)響應(yīng)內(nèi)容的情況下森爽，就可以獲取包含在響應(yīng)消息頭中的元信息。該方法常用于測(cè)試超鏈接的有效性嚣镜，是否可以訪問(wèn)爬迟，以及最近是否更新。
    GET	向特定的資源發(fā)出請(qǐng)求祈惶。注意：GET方法不應(yīng)當(dāng)被用于產(chǎn)生“副作用”的操作中，例如在web app中扮匠。其中一個(gè)原因是GET可能會(huì)被網(wǎng)絡(luò)蜘蛛等隨意訪問(wèn)捧请。
    POST	向指定資源提交數(shù)據(jù)進(jìn)行處理請(qǐng)求（例如提交表單或者上傳文件）。數(shù)據(jù)被包含在請(qǐng)求體中棒搜。POST請(qǐng)求可能會(huì)導(dǎo)致新的資源的建立和/或已有資源的修改疹蛉。
    PUT	向指定資源位置上傳其最新內(nèi)容。
    DELETE	請(qǐng)求服務(wù)器刪除Request-URI所標(biāo)識(shí)的資源力麸。
    TRACE	回顯服務(wù)器收到的請(qǐng)求可款，主要用于測(cè)試或診斷育韩。
    CONNECT	HTTP/1.1協(xié)議中預(yù)留給能夠?qū)⑦B接改為管道方式的代理服務(wù)器。
    PATCH	用來(lái)將局部修改應(yīng)用于某一資源闺鲸，添加于規(guī)范RFC5789筋讨。

  • 請(qǐng)求資源虛擬路徑

  • 請(qǐng)求協(xié)議

• 請(qǐng)求頭信息——header

  • POST請(qǐng)求頭是需要追那個(gè)請(qǐng)求主體的長(zhǎng)度；如果不注明長(zhǎng)度則不會(huì)發(fā)送請(qǐng)求主體信息摸恍；

    content-length:length # length為非零整型數(shù)據(jù)
    

  • 服務(wù)器要想能夠解析道POST數(shù)據(jù)還需要請(qǐng)求頭包含數(shù)據(jù)類型

    content-length:appliacation/x-www-from-urlencoded #數(shù)據(jù)編碼格式
    

  • 格式為key=>value鍵值對(duì)的形式

• 空行
• 請(qǐng)求主體信息
  • 使用“&”拼接在一起的key=>value鍵值對(duì)悉罕。

【注意】
請(qǐng)求頭信息與請(qǐng)求主體信息之間要有一個(gè)空行！

請(qǐng)求格式

METHOD /path-to-resource HTTP/Version-number
Header-name-1:Value
Header-name-2:Value

Optional request body

示例

# GET 請(qǐng)求
GET /generate_204 HTTP/1.1 //請(qǐng)求方法 請(qǐng)求虛擬路徑 請(qǐng)求協(xié)議——請(qǐng)求行
User-Agent: Dalvik/2.1.0 (Linux; U; Android 7.0; MI 5 MIUI/V9.5.1.0.NAACNFA)    //請(qǐng)求頭
Host: connect.rom.miui.com  //主機(jī)——請(qǐng)求頭
Connection: Keep-Alive  //請(qǐng)求頭
Accept-Encoding: gzip   //請(qǐng)求頭

# POST 請(qǐng)求
POST /quickService/ajax/getServiceCategory.ajax.php HTTP/1.1    //請(qǐng)求行
Host: api1.yaxinzhichuang.com   //請(qǐng)求頭
Content-Length: 26  //請(qǐng)求頭
Pragma: no-cache
Cache-Control: no-cache
Accept: application/json
Origin: http://api1.yaxinzhichuang.com
X-Requested-With: XMLHttpRequest
User-Agent: Mozilla/5.0 (Linux; Android 7.0; MI 5 Build/NRD90M; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/62.0.3202.84 Mobile Safari/537.36
Content-Type: application/x-www-form-urlencoded
Referer: http://api1.yaxinzhichuang.com/quickService/index.php?action=quickService
Accept-Encoding: gzip, deflate
Accept-Language: zh-CN,en-US;q=0.9
Cookie: PHPSESSID=497cde80b0d132a375e872bae9668c41
    // 空行
action=children&parentId=2  //  請(qǐng)求主體信息

Response——響應(yīng)

響應(yīng)內(nèi)容

響應(yīng)信息內(nèi)容包括以下幾點(diǎn)：

• 響應(yīng)行
  • 由HTTP協(xié)議版本號(hào)
  • 狀態(tài)碼
  • 狀態(tài)文字
• 響應(yīng)頭信息
  • 格式為key=>value鍵值對(duì)的形式
• 空行
• 響應(yīng)主體信息（也可能沒(méi)有）

響應(yīng)格式

HTTP/Version-number status-code message 
Header-name-1:Value
Header-name-2:Value

Optional response body

示例

## json響應(yīng)
HTTP/1.1 200 OK     //  響應(yīng)行
Date: Tue, 20 Mar 2018 16:11:59 GMT //響應(yīng)行
Server: Apache/2.2.34 (Unix)    //響應(yīng)行
Expires: Thu, 19 Nov 1981 08:52:00 GMT  //響應(yīng)行
Cache-Control: no-store, no-cache, must-revalidate, post-check=0, pre-check=0   //響應(yīng)行
Pragma: no-cache    //響應(yīng)行
Content-Length: 146 //響應(yīng)行
Content-Type: text/json;charset=utf-8   //響應(yīng)行
Proxy-Connection: Keep-alive    //響應(yīng)行
    //空行
{"Code":100000,"Msg":"操作成功立镶！","Data":{"List":[{"value":"7","text":"電腦系統(tǒng)服務(wù)"},{"value":"45","text":"維修"}],"uploadImg":"1"}}    ////響應(yīng)主體信息壁袄，可能是html頁(yè)面；

API

定義

一些預(yù)先定義的函數(shù)媚媒，目的是能夠讓應(yīng)用程序或開發(fā)人員能夠具有訪問(wèn)指定網(wǎng)絡(luò)資源的能力嗜逻，而無(wú)需關(guān)心訪問(wèn)的遠(yuǎn)嗎以及內(nèi)部的工作機(jī)制細(xì)節(jié)。

RESTful

為了統(tǒng)一API結(jié)構(gòu)設(shè)計(jì)規(guī)范提出的一種架構(gòu)標(biāo)準(zhǔn)缭召；然而栈顷，RESTful并不是唯一的API架構(gòu)標(biāo)準(zhǔn)。
REST是“REpresentational State Transfer”的縮寫恼琼；表現(xiàn)性狀態(tài)轉(zhuǎn)換妨蛹；

概念

在RESTful架構(gòu)中認(rèn)為所有一切都是資源，每個(gè)資源有對(duì)應(yīng)的URI^[2]標(biāo)識(shí)晴竞；
處理資源的操作有：

客戶端通過(guò)以上4種http動(dòng)詞蛙卤，對(duì)服務(wù)器資源進(jìn)行操作，實(shí)現(xiàn)“表現(xiàn)層狀態(tài)轉(zhuǎn)化”噩死；

【注意】
只是一種架構(gòu)而不是標(biāo)準(zhǔn)颤难，提供設(shè)計(jì)原則和約束條件。
適用于客戶端與服務(wù)器交互類的軟件已维，這是因?yàn)樗雍?jiǎn)潔行嗤、有層次、更利于實(shí)現(xiàn)緩存等機(jī)制垛耳；

規(guī)范

協(xié)議

REST API與客戶端通信協(xié)議為http協(xié)議栅屏；

域名

應(yīng)該盡量將API放在專屬于名下。

http://api.example.com

版本

應(yīng)該將API的版本好放入U(xiǎn)RL中堂鲜。

http://api.example.com/version/

路徑

表示API的具體網(wǎng)址栈雳，在RESTful架構(gòu)中，每個(gè)網(wǎng)址代表了一種資源缔莲，所以網(wǎng)址中不能有動(dòng)詞哥纫，只能有名詞，故API中的名詞應(yīng)該用復(fù)數(shù)形式痴奏。

http動(dòng)詞

對(duì)http資源的具體操作類型蛀骇，有http動(dòng)詞表示厌秒。

過(guò)濾信息

過(guò)濾信息可以理解為query string即：?limit=10&page=1&id=12；為API提供參數(shù)擅憔，過(guò)濾并返回結(jié)果鸵闪。

狀態(tài)碼

服務(wù)器向用戶返回的狀態(tài)嗎和提示信息，常見的有以下部分：

• 2XX：這一類型的狀態(tài)碼雕欺，代表請(qǐng)求已成功被服務(wù)器接收岛马、理解、并接受屠列。
• 3xx重定向：這類狀態(tài)碼代表需要客戶端采取進(jìn)一步的操作才能完成請(qǐng)求啦逆。通常，這些狀態(tài)碼用來(lái)重定向笛洛，后續(xù)的請(qǐng)求地址（重定向目標(biāo)）在本次響應(yīng)的Location域中指明夏志。當(dāng)且僅當(dāng)后續(xù)的請(qǐng)求所使用的方法是GET或者HEAD時(shí)，用戶瀏覽器才可以在沒(méi)有用戶介入的情況下自動(dòng)提交所需要的后續(xù)請(qǐng)求苛让」得铮客戶端應(yīng)當(dāng)自動(dòng)監(jiān)測(cè)無(wú)限循環(huán)重定向（例如：A→B→C→……→A或A→A），因?yàn)檫@會(huì)導(dǎo)致服務(wù)器和客戶端大量不必要的資源消耗狱杰。按照HTTP/1.0版規(guī)范的建議瘦材，瀏覽器不應(yīng)自動(dòng)訪問(wèn)超過(guò)5次的重定向。
• 4xx客戶端錯(cuò)誤：這類的狀態(tài)碼代表了客戶端看起來(lái)可能發(fā)生了錯(cuò)誤仿畸，妨礙了服務(wù)器的處理食棕。除非響應(yīng)的是一個(gè)HEAD請(qǐng)求，否則服務(wù)器就應(yīng)該返回一個(gè)解釋當(dāng)前錯(cuò)誤狀況的實(shí)體错沽，以及這是臨時(shí)的還是永久性的狀況簿晓。這些狀態(tài)碼適用于任何請(qǐng)求方法。瀏覽器應(yīng)當(dāng)向用戶顯示任何包含在此類錯(cuò)誤響應(yīng)中的實(shí)體內(nèi)容千埃。
• 5xx服務(wù)器錯(cuò)誤：表示服務(wù)器無(wú)法完成明顯有效的請(qǐng)求憔儿。這類狀態(tài)碼代表了服務(wù)器在處理請(qǐng)求的過(guò)程中有錯(cuò)誤或者異常狀態(tài)發(fā)生，也有可能是服務(wù)器意識(shí)到以當(dāng)前的軟硬件資源無(wú)法完成對(duì)請(qǐng)求的處理放可。除非這是一個(gè)HEAD請(qǐng)求谒臼，否則服務(wù)器應(yīng)當(dāng)包含一個(gè)解釋當(dāng)前錯(cuò)誤狀態(tài)以及這個(gè)狀況是臨時(shí)的還是永久的解釋信息實(shí)體。瀏覽器應(yīng)當(dāng)向用戶展示任何在當(dāng)前響應(yīng)中被包含的實(shí)體耀里。這些狀態(tài)碼適用于任何響應(yīng)方法蜈缤。

關(guān)于狀態(tài)碼詳情參見“維基百科揭秘——HTTP狀態(tài)碼”拌汇；

錯(cuò)誤信息

如果產(chǎn)生錯(cuò)誤，就應(yīng)該向用戶返回出錯(cuò)信息弊决。返回信息中將error作為建明噪舀，出錯(cuò)信息作為鍵值即可。

{
    "error":"Invalid API Key!"
}

返回結(jié)果

針對(duì)不同操作飘诗，服務(wù)器向用戶返回的結(jié)果應(yīng)該符合以下規(guī)范与倡。

GET /collection: 返回資源對(duì)象列表
GET /collection/resource:返回單個(gè)資源對(duì)象
POST /collection:返回新創(chuàng)建的資源對(duì)象
PUT /collection:返回完整的資源對(duì)象
PATCh /collection:返回完整的資源對(duì)象
DELETE /collection:返回一個(gè)空文檔

RESTful不規(guī)范使用

接口中添加GET/UPDATE等動(dòng)詞

在URI中添加操作名稱；而是應(yīng)該通過(guò)http動(dòng)詞表示請(qǐng)求資源的操作動(dòng)作疚察，如：GET/UPDATE，來(lái)表示接口的含義仇奶；

//不規(guī)范使用方法
GET /getUser
POST /updateUser
POST /cowfarm/cowfarmemp/new
POST /cowfarm/cowfarmemp/update
POST /cowfarm/cowfarmemp/delete/{id}

//正確使用方法
GET /user               # 獲取一個(gè)用戶的信息貌嫡；
PUT /user               # 更新用戶的信息；
POST /cowfarm/employee  # 表示 新建一個(gè)農(nóng)場(chǎng)的雇員/員工该溯；
PUT /cowfarm/employee   # 表示 更新農(nóng)場(chǎng)雇員/員工的信息岛抄；
DELETE /cowfarm/employee# body中包含json參數(shù)，表示刪除用戶狈茉，且返回值中夫椭，message，code應(yīng)該正常返回氯庆，data就沒(méi)必要返回了

非改動(dòng)資源的操作卻設(shè)計(jì)為POST/PUT等方法

對(duì)于沒(méi)有新增/更新/刪除等去改動(dòng)和影響資源的操作蹭秋，HTTP的方法卻設(shè)計(jì)為POST/PUT等

RESTful API返回?cái)?shù)據(jù)的格式

常用數(shù)據(jù)返回格式為json格式，或者使用比較少的XML堤撵。

1. 超文本：超文本系統(tǒng)是一種提供了復(fù)雜格式的解釋的軟件系統(tǒng)仁讨，包括文本，圖像实昨，超鏈接一種文字間的跳轉(zhuǎn)以提供某一個(gè)關(guān)鍵詞的相關(guān)內(nèi)容洞豁。 ?

2. URI：統(tǒng)一資源標(biāo)識(shí)符（英語(yǔ)：Uniform Resource Identifier，或URI）是一個(gè)用于標(biāo)識(shí)某一互聯(lián)網(wǎng)資源名稱的字符串荒给≌尚可以這么理解URI=URL+URN；URL(定位符——資源地址)和URN(名稱——資源名稱)方案屬于URI的子類志电，URI可以為URL或URN兩者之一或同時(shí)是URI和URN曙咽。技術(shù)上講，URL和URN屬于資源ID挑辆；但是桐绒，人們往往無(wú)法將某種方案歸類于兩者中的某一個(gè)：所有的URI都可被作為名稱看待夺脾，而某些方案同時(shí)體現(xiàn)了兩者中的不同部分。 ? ?