Show in graph
API

Product → API Products

HTTP Method

A verb-like part of an HTTP request that communicates the intended operation.

Motivation

HTTP methods solve the problem of expressing the intended operation of a request.

Where it fits

HTTP Method belongs to API products and web protocols, especially REST-style APIs.

Mental model

The method is the verb of an HTTP request: read, submit, replace, update, or delete a resource-oriented operation.

Subconcepts

GET

Reads a resource representation without intending to change server state.

POST

Submits data to create or process a resource-oriented operation.

PUT

Replaces or creates a resource at a known URI and is usually idempotent.

DELETE

Removes a resource and is usually designed to be idempotent.

Common mistakes

  • Using POST for every operation without considering semantics.
  • Assuming idempotency is automatic just because a method convention says it should be.

HTTP Method connects to HTTP, REST, CRUD, idempotency, and API design.