14HTTP

全文網(wǎng)址https://www.kancloud.cn/kancloud/http-api-guide/56269

疑問點(diǎn):

1.身份驗(yàn)證中的“HTTP 基本認(rèn)證牵触,只有在部署了 SSL 證書的情況下才可以使用佛析,否則用戶密碼會(huì)有暴露的風(fēng)險(xiǎn)廓八,當(dāng)然苟蹈,最好不要使用”。
這里的SSL證書是啥東西租副?先mark郑藏,留著以后做網(wǎng)頁了解答。

2.CORS中呵晚,javascript,瀏覽器蜘腌,服務(wù)器三個(gè),第一個(gè)代表什么饵隙。

請(qǐng)求方法

rest:前端后端分離的一種方法撮珠。

可用于集合集合

GET http://localhost/hotels/(用于從服務(wù)器獲得某個(gè)資源的信息)

POST http://localhost/hotels/(用于創(chuàng)建新資源)

=================

可用于單個(gè)

GET http://localhost/hotels/656bcee2-28d2-404b-891b

GET http://localhost/hotels/1

PUT http://localhost/hotels/656bcee2-28d2-404b-891b(可用于整體的替換/創(chuàng)建)

PATCH http://localhost/hotels/656bcee2-28d2-404b-891b(局部更新,類似微信修改微信頭像)

DELETE http://localhost/hotels/656bcee2-28d2-404b-891b(刪除單個(gè))

HTTP協(xié)議

HTTP1.1

2016年IETF廢除RFC2616癞季,將1.1拆分成6個(gè)單獨(dú)協(xié)議:

  • 信息語法和路由選擇:低級(jí)信息語法分析和連接管理

  • 語意論和目錄:方法劫瞳,狀態(tài)代碼和標(biāo)題

  • 條件請(qǐng)求:e.g., If-Modified-Since

  • 范圍請(qǐng)求:獲得局部目錄

  • 緩存:瀏覽器和中間緩存

  • 鑒定:HTTP鑒定框架

HTTP2.0

2.0 版本的設(shè)計(jì)目標(biāo)是盡量在使用層面上保持與 1.1 版本的兼容倘潜,所以绷柒,雖然數(shù)據(jù)交換的格式發(fā)生了變化,但語義基本全部被保留下來了涮因。

URL

強(qiáng)烈建議 API 部署 SSL 證書废睦,這樣接口傳遞的數(shù)據(jù)的安全性才能都得一定的保障。

空字段

接口遵循“輸入寬容养泡,輸出嚴(yán)格”原則嗜湃,輸出的數(shù)據(jù)結(jié)構(gòu)中空字段的值一律為 null

國際化

  • 語言標(biāo)簽

RFC規(guī)定的語言標(biāo)簽順序?yàn)椋?/p>

language(必填)-script-region-variant-extension-privateuse

疑問點(diǎn):這些script和region的簡稱都去哪里得到。

其中只有 language 部分是必須的澜掩,其他部分都是可選的购披;不過為了便于編寫程序,建議設(shè)計(jì)接口時(shí)約定語言標(biāo)簽的結(jié)構(gòu)肩榕,比如統(tǒng)一使用 language-script-region 的形式( zh-Hans-CN, zh-Hant-HK 等等)刚陡。

  • 時(shí)區(qū)

  • 貨幣名稱

貨幣名稱可以參考 ISO 4217 中的約定,標(biāo)準(zhǔn)為貨幣名稱規(guī)定了三個(gè)字母的貨幣代碼。

前兩位是ISO 3166-1Wikipedia 中定義雙字母國家代碼筐乳,第三個(gè)字母通常是貨幣的首字母

狀態(tài)碼

  • 請(qǐng)求成功

  • 重定向

  • 條件請(qǐng)求

  • 客戶端錯(cuò)誤

  • 服務(wù)端錯(cuò)誤

錯(cuò)誤處理

身份驗(yàn)證

歌殃?

超文本驅(qū)動(dòng)和資源發(fā)現(xiàn)

分頁

請(qǐng)求某個(gè)資源集合時(shí),可以通過指定 count 參數(shù)來指定每頁的資源數(shù)量蝙云,通過 page 參數(shù)指定頁碼氓皱,或根據(jù) last_cursor 參數(shù)指定上一頁最后一個(gè)資源的標(biāo)識(shí)符。

如果沒有傳遞 count 參數(shù)或者 count 參數(shù)的值為空勃刨,則使用默認(rèn)值 20 波材, count 參數(shù)的最大上限為 100 。

如何同時(shí)傳遞了 last_cursor 和 page 參數(shù)朵你,則使用 page 各聘。

分頁的相關(guān)信息會(huì)包含在 Link Header 和 X-Total-Count 中。


HTTP/1.1 200 OK

X-Total-Count: 542

Link: <http://api.example.com/#{RESOURCE_URI}?last_cursor=&count=100>; rel="first",

 <http://api.example.com/#{RESOURCE_URI}?last_cursor=200&count=100>; rel="last"

 <http://api.example.com/#{RESOURCE_URI}?last_cursor=90&count=100>; rel="previous",

 <http://api.example.com/#{RESOURCE_URI}?last_cursor=120&count=100>; rel="next",

[

 ...

]

數(shù)據(jù)緩存

大部分接口應(yīng)該在響應(yīng)頭中攜帶 Last-Modified, ETag, Vary, Date 信息抡医,客戶端可以在隨后請(qǐng)求這些資源的時(shí)候躲因,在請(qǐng)求頭中使用 If-Modified-Since, If-None-Match 等請(qǐng)求頭來確認(rèn)資源是否經(jīng)過修改。

如果資源沒有進(jìn)行過修改忌傻,那么就可以響應(yīng) 304 Not Modified 并且不在響應(yīng)實(shí)體中返回任何內(nèi)容大脉。

跨域 CORS cross origin resourse sharing

https://www.kancloud.cn/kancloud/http-api-guide/56271

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個(gè)濱河市水孩,隨后出現(xiàn)的幾起案子镰矿,更是在濱河造成了極大的恐慌,老刑警劉巖俘种,帶你破解...
    沈念sama閱讀 217,509評(píng)論 6 504
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件秤标,死亡現(xiàn)場(chǎng)離奇詭異,居然都是意外死亡宙刘,警方通過查閱死者的電腦和手機(jī)苍姜,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,806評(píng)論 3 394
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來悬包,“玉大人衙猪,你說我怎么就攤上這事〔冀” “怎么了垫释?”我有些...
    開封第一講書人閱讀 163,875評(píng)論 0 354
  • 文/不壞的土叔 我叫張陵,是天一觀的道長撑瞧。 經(jīng)常有香客問我棵譬,道長,這世上最難降的妖魔是什么预伺? 我笑而不...
    開封第一講書人閱讀 58,441評(píng)論 1 293
  • 正文 為了忘掉前任订咸,我火速辦了婚禮琅束,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘算谈。我一直安慰自己涩禀,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,488評(píng)論 6 392
  • 文/花漫 我一把揭開白布然眼。 她就那樣靜靜地躺著艾船,像睡著了一般。 火紅的嫁衣襯著肌膚如雪高每。 梳的紋絲不亂的頭發(fā)上屿岂,一...
    開封第一講書人閱讀 51,365評(píng)論 1 302
  • 那天,我揣著相機(jī)與錄音鲸匿,去河邊找鬼爷怀。 笑死,一個(gè)胖子當(dāng)著我的面吹牛带欢,可吹牛的內(nèi)容都是我干的运授。 我是一名探鬼主播,決...
    沈念sama閱讀 40,190評(píng)論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼乔煞,長吁一口氣:“原來是場(chǎng)噩夢(mèng)啊……” “哼吁朦!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起渡贾,我...
    開封第一講書人閱讀 39,062評(píng)論 0 276
  • 序言:老撾萬榮一對(duì)情侶失蹤逗宜,失蹤者是張志新(化名)和其女友劉穎,沒想到半個(gè)月后空骚,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體纺讲,經(jīng)...
    沈念sama閱讀 45,500評(píng)論 1 314
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,706評(píng)論 3 335
  • 正文 我和宋清朗相戀三年囤屹,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了熬甚。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 39,834評(píng)論 1 347
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡牺丙,死狀恐怖则涯,靈堂內(nèi)的尸體忽然破棺而出复局,到底是詐尸還是另有隱情冲簿,我是刑警寧澤,帶...
    沈念sama閱讀 35,559評(píng)論 5 345
  • 正文 年R本政府宣布亿昏,位于F島的核電站峦剔,受9級(jí)特大地震影響,放射性物質(zhì)發(fā)生泄漏角钩。R本人自食惡果不足惜吝沫,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,167評(píng)論 3 328
  • 文/蒙蒙 一呻澜、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧惨险,春花似錦羹幸、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,779評(píng)論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至恭朗,卻和暖如春屏镊,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背痰腮。 一陣腳步聲響...
    開封第一講書人閱讀 32,912評(píng)論 1 269
  • 我被黑心中介騙來泰國打工而芥, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人膀值。 一個(gè)月前我還...
    沈念sama閱讀 47,958評(píng)論 2 370
  • 正文 我出身青樓棍丐,卻偏偏與公主長得像,于是被迫代替她去往敵國和親沧踏。 傳聞我的和親對(duì)象是個(gè)殘疾皇子骄酗,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 44,779評(píng)論 2 354

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