Skip to main content
cd ../lexicon
sys/docs/lexicon/http.md
Lexicon
HTTP

HTTP

HTTP is a stateless application-level protocol for exchanging request and response messages. A safe HTTP workflow constrains its target, records request and response evidence, defines observable success and avoids assuming that transport success proves application success.
Difficulty: Introductory
5 min read
Updated 2026-09-09

In plain English

Plain definition

HTTP is a stateless application-level protocol for exchanging request and response messages. A safe HTTP workflow constrains its target, records request and response evidence, defines observable success and avoids assuming that transport success proves application success.

Technical definition

HTTP is a generic interface for interacting with a target resource through request and response messages. A request identifies a method and target and can include header fields and content. A response includes a status code and can likewise include header fields and content. The method communicates request semantics, while the status code reports how the server handled the request.

HTTP is stateless: each request can be understood independently. Applications can create continuity through mechanisms such as authentication context or cookies, but that application state does not change the protocol’s stateless request model. Intermediaries may participate between client and origin server, so observed behaviour can also depend on gateways, proxies or caches.

Operational relevance

Operations teams use HTTP evidence to separate protocol observations from conclusions about service health. Useful evidence includes the intended target, method, response status, relevant header fields, response content where safe to retain, timing and the observation point. Sensitive credentials, tokens and private payloads should not be captured in routine evidence.

A bounded validation begins with a non-production target and a request whose effects are known. Observable success should be defined before execution. For a read-only request, success might require the expected status code, representation characteristics and application-level content. A transport connection alone is insufficient.

Common failure signals include no response because name resolution or connectivity failed; an unexpected status because routing, authentication or application logic rejected the request; and a plausible response that contains the wrong representation. Operators should stop when the target, permissions or potential effect cannot be confirmed.

Architecture relationship

HTTP sits at an application-protocol boundary between a user agent or service client and a server. The exchange may cross transport security, load balancers, reverse proxies, caches, gateways and application components. Each boundary can affect routing, authentication, representation selection or observability.

This layered relationship matters during diagnosis. A successful network path does not prove correct HTTP semantics, and an HTTP success status does not necessarily prove completion of a downstream business process. Evidence should therefore be collected at the layer where the claimed outcome can be observed.

Example

Consider a read-only health representation in an isolated environment. The operator records the approved URI, uses the documented safe method and checks the response against a pre-agreed status and content expectation. The workflow passes only when the HTTP response and the service-level evidence both match those expectations.

If the response is absent, unexpectedly redirected, unauthorised or structurally wrong, the operator preserves non-sensitive evidence and stops rather than broadening scope. Because the example does not change server state, recovery consists of ending the test and correcting the target, routing or expectation before repeating it. Any workflow that could modify data requires a product-specific rollback plan established before execution.

Misunderstanding

A common misunderstanding is that HTTP is merely a transport or that one successful status code proves an application is healthy. HTTP defines application-level message semantics and can operate through several intermediaries. Status codes are material evidence, but they must be interpreted with the request method, target, header fields, content and intended application outcome.

Another mistake is to treat every method as safely repeatable. Method semantics matter, and an implementation can have effects outside the protocol exchange. Do not test an unfamiliar endpoint on production solely because the request appears small or syntactically valid.

  • Client: the participant that initiates an HTTP request.
  • Server: the participant that accepts a connection to service HTTP requests and sends responses.
  • Resource: the target of an HTTP request, identified through a URI.
  • Method: the request token that identifies the requested semantics.
  • Status code: the three-digit response code describing the result of handling the request.
  • Header field: message metadata that can modify or describe an exchange.
  • Intermediary: a proxy, gateway or tunnel participating between client and server.

Further reading and safe next step

RFC 9110, HTTP Semantics, is the primary source used for this definition. It should be consulted for precise method, status-code, field and resource semantics. Product documentation remains necessary for implementation-specific endpoints, permissions and recovery procedures.

Before validating a real workflow, confirm the deployed product version, request target, authorised identity and expected effect. Start with a documented read-only request in an isolated environment. Proceed only when the response and independent service evidence satisfy the declared pass conditions; otherwise retain non-sensitive observations, stop and escalate to the service owner. No state-changing operation should proceed without a tested, product-specific recovery path.