Skip to main content

Glossary (术语表)

核心概念​

Resource (资源)​

信息的抽象概念，可以通过URI标识的任何事物。资源可以是文档、图像、服务、人员、或抽象概念。

示例:

  • https://api.example.com/users/123 - 用户资源
  • https://example.com/logo.png - 图像资源

Representation (表示)​

资源在特定时间点的状态信息，由数据和描述数据的元数据组成。

示例:

Content-Type: application/json
Content-Language: zh-CN

{"id": 123, "name": "张三"}

User Agent (用户代理)​

发起HTTP请求的客户端程序，如浏览器、移动应用、命令行工具。

示例: 浏览器、curl、移动应用

Origin Server (源服务器)​

资源的权威来源，能够提供资源的最终表示的服务器。

方法属性​

Safe Method (安全方法)​

只读操作，不请求也不期望改变服务器状态的方法。

安全方法: GET, HEAD, OPTIONS, TRACE

Idempotent Method (幂等方法)​

多次相同请求的效果与单次请求相同的方法。

幂等方法: GET, HEAD, PUT, DELETE, OPTIONS, TRACE

Cacheable Method (可缓存方法)​

响应可以存储并在后续请求中重用的方法。

可缓存方法: GET, HEAD, POST (有条件)

内容协商​

Proactive Negotiation (主动协商)​

客户端通过请求头部指定偏好，服务器选择最佳表示。

请求头部: Accept, Accept-Language, Accept-Encoding, Accept-Charset

Reactive Negotiation (响应式协商)​

服务器提供多个选择，客户端选择合适的表示。

状态码: 300 Multiple Choices

Content Negotiation (内容协商)​

在同一资源的多个表示中选择最佳表示的机制。

头部字段​

Representation Metadata (表示元数据)​

描述表示的数据的头部字段。

示例: Content-Type, Content-Encoding, Content-Language, Content-Location

Request Modifiers (请求修饰符)​

修改请求语义的头部字段。

示例: If-Modified-Since, If-None-Match, Range

Response Control Data (响应控制数据)​

控制响应处理的头部字段。

示例: Age, Cache-Control, Expires, Vary

状态码术语​

1xx Informational (信息性响应)​

临时响应，指示请求已接收并继续处理。

示例: 100 Continue, 101 Switching Protocols

2xx Successful (成功)​

请求已成功接收、理解并接受。

示例: 200 OK, 201 Created, 204 No Content

3xx Redirection (重定向)​

需要进一步操作以完成请求。

示例: 301 Moved Permanently, 302 Found, 304 Not Modified

4xx Client Error (客户端错误)​

请求包含语法错误或无法完成。

示例: 400 Bad Request, 404 Not Found, 403 Forbidden

5xx Server Error (服务器错误)​

服务器未能完成有效的请求。

示例: 500 Internal Server Error, 503 Service Unavailable

消息组件​

Message (消息)​

HTTP通信的基本单元，由头部和可选的消息体组成。

类型: Request Message (请求消息), Response Message (响应消息)

Header Field (头部字段)​

消息中的元数据，格式为 field-name: field-value。

示例:

Content-Type: application/json
Content-Length: 123

Message Body (消息体)​

传输的实际数据。

Payload (负载)​

请求或响应中传输的数据及其元数据。

缓存相关​

Fresh (新鲜)​

缓存响应在其有效期内，可以直接使用而无需重新验证。

Stale (陈旧)​

缓存响应已过期，需要重新验证或获取新的响应。

Cache-Control (缓存控制)​

指令，用于控制缓存行为。

示例:

Cache-Control: max-age=3600
Cache-Control: no-cache
Cache-Control: private

连接相关​

Connection (连接)​

客户端和服务器之间的传输层连接。

Persistent Connection (持久连接)​

可用于多个请求/响应交换的连接。

HTTP/1.1: 默认持久连接

其他术语​

URI (Uniform Resource Identifier)​

统一资源标识符，用于标识资源。

格式: scheme://authority/path?query#fragment

示例: https://api.example.com/users?page=1

Media Type (媒体类型)​

资源表示的格式，也称为MIME类型。

格式: type/subtype[;parameter=value]

示例: application/json, text/html; charset=utf-8

Quality Value (质量值)​

表示偏好程度的数值，范围0.0-1.0。

示例: Accept: text/html, application/json;q=0.9

Payload Too Large (负载过大)​

请求或响应的消息体超过服务器愿意或能够处理的大小。

状态码: 413 Payload Too Large

缩写​

缩写全称中文
HTTPHypertext Transfer Protocol超文本传输协议
URIUniform Resource Identifier统一资源标识符
URLUniform Resource Locator统一资源定位符
MIMEMultipurpose Internet Mail Extensions多用途互联网邮件扩展
ABNFAugmented Backus-Naur Form增强巴科斯-诺尔范式
IANAInternet Assigned Numbers Authority互联网号码分配机构
RFCRequest for Comments请求评论
IETFInternet Engineering Task Force互联网工程任务组

返回: RFC 7231主页

Last updated on