与HTTP标签相关的技术文章 - 时代Java，与您同行！

时代Java，与您同行！关注微信公众号，关注前沿技术，微信搜索：nowjava或时代Java，也可点击这里扫码关注

时代Java

登录注册

与 “HTTP” 标签相关内容。

HTTP API 设计指南

我们的目标是保持一致性，专注业务逻辑同时避免过度设计。我们一直试图找出一种良好的、一致的、显而易见的 API 设计方法，而并不是所谓的"最终/理想模式"。

欢马劈雪 2020-12-28 01:56:55 2020-12-28 01:56:55

http， api，设计，指南
升级HTTP

花点功夫去改善HTTP协议显然是极好的事情。我们可以着手于以下几个方面：降低协议对延迟的敏感修复pipelining和head of line blocking的问题防止主机需求更高的连接数量保留所有现有的接口，内容，URI格式和结构由IETF的HTTPbis工作组来制定 4.1. IETF和HTTPbis工作组The Internet Engineering Task Force (IETF)是一个开发和推广互联网标准的组织。

欢马劈雪 2020-08-04 05:37:59 2020-08-04 05:37:59

升级， http， http2，讲解
HTTP 的现状

互联网上几乎所有内容都采用HTTP 1.1作为通信协议。人们在该协议上投入了大量精力，基于它的基础架构也因此日臻完善。正因如此，在HTTP协议之上构建新的方案会比从底层建立新的协议容易得多。2.1. HTTP 1.1过于庞大HTTP刚诞生的时候只被当作是一个相对简单直观的协议，但时间证明这种初始设计并不如意。定义HTTP 1.0规范的RFC 1945共有60页，发布于1996年。

欢马劈雪 2020-08-04 05:37:59 2020-08-04 05:37:59

http，现状， http2，讲解
HTTP/3 原理实战及HTTP历史

2015 年 HTTP/2 标准发表后，大多数主流浏览器也于当年年底支持该标准。此后，凭借着多路复用、头部压缩、服务器推送等优势，HTTP/2 得到了越来越多开发者的青睐。不知不觉的 HTTP 已经发展到了第三代，鹅厂也紧跟技术潮流，很多项目也在逐渐使用 HTTP/3。本文基于兴趣部落接入 HTTP/3 的实践，聊一聊 HTTP/3 的原理以及业务接入的方式。

欢马劈雪 2020-05-25 05:47:18 2020-05-25 05:47:18

HTTP/3，原理，实战， HTTP，历史
让你的Spring Boot工程支持HTTP和HTTPS

如今，企业级应用程序的常见场景是同时支持HTTP和HTTPS两种协议，这篇文章考虑如何让Spring Boot应用程序同时支持HTTP和HTTPS两种协议。准备为了使用HTTPS连接器，需要生成一份Certificate keystore，用于加密和机密浏览器的SSL沟通。

欢马劈雪 2020-08-04 05:37:59 2020-08-04 05:37:59

spring， boot，工程，支持， http
Spring Boot：定制HTTP消息转换器

在构建RESTful数据服务过程中，我们定义了controller、repositories，并用一些注解修饰它们，但是到现在为止我们还没执行过对象的转换——将java实体对象转换成HTTP的数据输出流。Spring Boot底层通过HttpMessageConverters依靠Jackson库将Java实体类输出为JSON格式。当有多个转换器可用时，根据消息对象类型和需要的内容类型选择最适合的转换器使用。

欢马劈雪 2020-08-04 05:37:59 2020-08-04 05:37:59

spring， boot，定制， http，消息
良好打印的默认 JSON

用户第一次查看你的 API 很可能是在使用 curl 的命令行里。如果 API 的响应有良好的打印格式，那在命令行里它们会很容易理解。为了给这些开发者提供方便，良好打印格式的 JSON 如下：{ "beta": false, "email": "alice@heroku.

欢马劈雪 2020-08-04 05:37:59 2020-08-04 05:37:59

良好，打印，默认， json， http
描述稳定性

描述您的 API 的稳定性或是它在各种各样节点环境中的完备性和稳定性，例如：加上原型版（prototype）/开发版（development）/产品版（production）等标记。更多关于可能的稳定性和改变管理的方式，查看 Heroku API compatibility policy一旦你的 API 宣布产品正式版本及稳定版本时，不要在当前 API 版本中做一些不兼容的改变。如果你需要，请创建一个新的版本的 API。

欢马劈雪 2020-08-04 05:37:59 2020-08-04 05:37:59

描述，稳定性， http， api，设计
提供可执行的例子

提供可执行的示例让用户可以直接在终端里面看到 API 的调用情况，最大程度的让这些示例可以简单的使用，以减少用户尝试使用 API 的工作量。例如:$ export TOKEN=... # acquire from dashboard$ curl -is https://$TOKEN@service.com/users如果你使用prmd生成 Markdown 文档，每个节点都会自动获取一些示例。

欢马劈雪 2020-08-04 05:37:59 2020-08-04 05:37:59

提供，可执行，例子， http， api
可读性

机器可读的 JSON 模式提供一个机器可读的模式可以精确的指定你的 API。使用 prmd 来管理你的模式，并确保它能被prmd verify 验证。人类可读的文档提供人类可读的文档让客户端开发人员可以理解你的 API。如果你用 prmd 创建了一个概要并且按上述要求描述，你可以为所有节点很容易的使用prmd doc生成 Markdown文档。

欢马劈雪 2020-08-04 05:37:59 2020-08-04 05:37:59

可读性， http， api，设计，指南
保证响应 JSON 最小化

请求中多余的空格会增加响应大小，而且现在很多的 HTTP 客户端都会自己输出可读格式（"prettify"）的 JSON。所以最好保证响应 JSON 最小化，例如：{"beta":false,"email":"alice@heroku.

欢马劈雪 2020-08-04 05:37:59 2020-08-04 05:37:59

保证，响应， json，最小化， http
显示频率限制状态

客户端的访问速度限制可以维护服务器的良好状态，保证为其他客户端请求提供高性的服务。你可以使用token bucket algorithm技术量化请求限制。为每一个带有RateLimit-Remaining响应头的请求，返回预留的请求 tokens。

欢马劈雪 2020-08-04 05:37:59 2020-08-04 05:37:59

显示，频率，限制，状态， http
生成结构化的错误

响应错误的时，生成统一的、结构化的错误信息。包含一个机器可读的错误 id，一个人类能识别的错误信息（message），根据情况可以添加一个url来告诉客户端关于这个错误的更多信息以及如何去解决它，例如:HTTP/1.1 429 Too Many Requests{ "id": "rate_limit", "message": "Account reached its API rate limit.", "url": "https://docs.service.

欢马劈雪 2020-08-04 05:37:59 2020-08-04 05:37:59

生成，结构化，错误， http， api
嵌套外键关系

使用嵌套对象序列化外键关联，例如:{ "name": "service-production", "owner": { "id": "5d8201b0..." }, // ...}而不是像这样:{ "name": "service-production", "owner_id": "5d8201b0...", ...

欢马劈雪 2020-08-04 05:37:59 2020-08-04 05:37:59

嵌套，关系， http， api，设计
提供标准的时间戳

为资源提供默认的创建时间 created_at 和更新时间 updated_at，例如:{ ... "created_at": "2012-01-01T12:00:00Z", "updated_at": "2012-01-01T13:00:00Z", ...}有些资源不需要使用时间戳那么就忽略这两个字段。

欢马劈雪 2020-08-04 05:37:59 2020-08-04 05:37:59

提供，标准，时间戳， http， api
提供资源的(UU)ID

在默认情况给每一个资源一个id属性。除非有更好的理由，否则请使用 UUID。不要使用那种在服务器上或是资源中不是全局唯一的标识，尤其是自动增长的 id。生成小写的UUID格式 8-4-4-4-12，例如："id": "01234567-89ab-cdef-0123-456789abcdef"

欢马劈雪 2020-08-04 05:37:59 2020-08-04 05:37:59

提供，资源， uu， id， http
最小化路径嵌套

在一些有父路径/子路径嵌套关系的资源数据模块中，路径可能有非常深的嵌套关系，例如:/orgs/{org_id}/apps/{app_id}/dynos/{dyno_id}推荐在根(root)路径下指定资源来限制路径的嵌套深度。使用嵌套指定范围的资源。在上述例子中，dyno 属于 app，app 属于 org 可以表示为：/orgs/{org_id}/orgs/{org_id}/apps/apps/{app_id}/apps/{app_id}/dynos/dynos/{dyno_id}

欢马劈雪 2020-08-04 05:37:59 2020-08-04 05:37:59

最小化，路径，嵌套， http， api
路径和属性要小写

为了和域名命名规则保持一致，使用小写字母并用-分割路径名字，例如：service-api.com/usersservice-api.com/app-setups属性也使用小写字母，但是属性名要用下划线_分割，以便在Javascript中省略引号。例如：service_class: "first"

欢马劈雪 2020-08-04 05:37:59 2020-08-04 05:37:59

路径，属性，小写， http， api
提供全部可用的资源

提供全部可显现的资源 (例如：这个对象的所有属性) ，当响应码为 200 或是 201 时返回所有可用资源，包含 PUT/PATCH 和 DELETE请求，例如:$ curl -X DELETE \ https://service.com/apps/1f9b/domains/0fd4HTTP/1.1 200 OKContent-Type: application/json;charset=utf-8...{ "created_at": "2012-01-01T12:00:00Z", "hostname": "subdomain.example.

欢马劈雪 2020-08-04 05:37:59 2020-08-04 05:37:59

提供，全部，可用，资源， http
返回合适的状态码

为每一次的响应返回合适的HTTP状态码。

欢马劈雪 2020-08-04 05:37:59 2020-08-04 05:37:59

返回，合适，状态， http， api

HTTP API 设计指南

升级HTTP

HTTP 的现状

HTTP/3 原理实战及HTTP历史

让你的Spring Boot工程支持HTTP和HTTPS

Spring Boot：定制HTTP消息转换器

良好打印的默认 JSON

描述稳定性

提供可执行的例子

可读性

保证响应 JSON 最小化

显示频率限制状态

生成结构化的错误

嵌套外键关系

提供标准的时间戳

提供资源的(UU)ID

最小化路径嵌套

路径和属性要小写

提供全部可用的资源

返回合适的状态码

热门标签

社区

关于