14HTTP

全文网址https://www.kancloud.cn/kancloud/http-api-guide/56269

疑问点:

1.身份验证中的“HTTP 基本认证,只有在部署了 SSL 证书的情况下才可以使用,否则用户密码会有暴露的风险,当然,最好不要使用”。
这里的SSL证书是啥东西?先mark,留着以后做网页了解答。

2.CORS中,javascript,浏览器,服务器三个,第一个代表什么。

请求方法

rest:前端后端分离的一种方法。

可用于集合集合

GET http://localhost/hotels/(用于从服务器获得某个资源的信息)

POST http://localhost/hotels/(用于创建新资源)

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

可用于单个

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

GET http://localhost/hotels/1

PUT http://localhost/hotels/656bcee2-28d2-404b-891b(可用于整体的替换/创建)

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

DELETE http://localhost/hotels/656bcee2-28d2-404b-891b(删除单个)

HTTP协议

HTTP1.1

2016年IETF废除RFC2616,将1.1拆分成6个单独协议:

  • 信息语法和路由选择:低级信息语法分析和连接管理

  • 语意论和目录:方法,状态代码和标题

  • 条件请求:e.g., If-Modified-Since

  • 范围请求:获得局部目录

  • 缓存:浏览器和中间缓存

  • 鉴定:HTTP鉴定框架

HTTP2.0

2.0 版本的设计目标是尽量在使用层面上保持与 1.1 版本的兼容,所以,虽然数据交换的格式发生了变化,但语义基本全部被保留下来了。

URL

强烈建议 API 部署 SSL 证书,这样接口传递的数据的安全性才能都得一定的保障。

空字段

接口遵循“输入宽容,输出严格”原则,输出的数据结构中空字段的值一律为 null

国际化

  • 语言标签

RFC规定的语言标签顺序为:

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

疑问点:这些script和region的简称都去哪里得到。

其中只有 language 部分是必须的,其他部分都是可选的;不过为了便于编写程序,建议设计接口时约定语言标签的结构,比如统一使用 language-script-region 的形式( zh-Hans-CN, zh-Hant-HK 等等)。

  • 时区

  • 货币名称

货币名称可以参考 ISO 4217 中的约定,标准为货币名称规定了三个字母的货币代码。

前两位是ISO 3166-1Wikipedia 中定义双字母国家代码,第三个字母通常是货币的首字母

状态码

  • 请求成功

  • 重定向

  • 条件请求

  • 客户端错误

  • 服务端错误

错误处理

身份验证

超文本驱动和资源发现

分页

请求某个资源集合时,可以通过指定 count 参数来指定每页的资源数量,通过 page 参数指定页码,或根据 last_cursor 参数指定上一页最后一个资源的标识符。

如果没有传递 count 参数或者 count 参数的值为空,则使用默认值 20 , count 参数的最大上限为 100 。

如何同时传递了 last_cursor 和 page 参数,则使用 page 。

分页的相关信息会包含在 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",

[

 ...

]

数据缓存

大部分接口应该在响应头中携带 Last-Modified, ETag, Vary, Date 信息,客户端可以在随后请求这些资源的时候,在请求头中使用 If-Modified-Since, If-None-Match 等请求头来确认资源是否经过修改。

如果资源没有进行过修改,那么就可以响应 304 Not Modified 并且不在响应实体中返回任何内容。

跨域 CORS cross origin resourse sharing

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

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 159,015评论 4 362
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,262评论 1 292
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,727评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,986评论 0 205
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,363评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,610评论 1 219
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,871评论 2 312
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,582评论 0 198
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,297评论 1 242
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,551评论 2 246
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,053评论 1 260
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,385评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,035评论 3 236
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,079评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,841评论 0 195
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,648评论 2 274
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,550评论 2 270

推荐阅读更多精彩内容