REST · JSON Structure

Rest Architecture Structure

JSON structure documenting the key concepts, constraints, and components of the REST architectural style.

Type: Properties: 0
API DesignArchitectureHTTPRESTRESTfulWeb Services

Rest Architecture Structure is a JSON Structure definition published by REST.

Meta-schema:

JSON Structure

rest-architecture-structure.json Raw ↑ 
{
  "title": "REST Architecture Structure",
  "description": "JSON structure documenting the key concepts, constraints, and components of the REST architectural style.",
  "version": "1.0.0",
  "constraints": [
    "Client-Server",
    "Stateless",
    "Cacheable",
    "Uniform Interface",
    "Layered System",
    "Code on Demand (optional)"
  ],
  "uniformInterfaceConstraints": [
    "Identification of Resources",
    "Manipulation Through Representations",
    "Self-Descriptive Messages",
    "Hypermedia as the Engine of Application State (HATEOAS)"
  ],
  "httpMethods": {
    "GET": { "safe": true, "idempotent": true, "cacheable": true, "purpose": "Read resource" },
    "HEAD": { "safe": true, "idempotent": true, "cacheable": true, "purpose": "Read headers only" },
    "OPTIONS": { "safe": true, "idempotent": true, "cacheable": false, "purpose": "Discover capabilities" },
    "POST": { "safe": false, "idempotent": false, "cacheable": false, "purpose": "Create resource or action" },
    "PUT": { "safe": false, "idempotent": true, "cacheable": false, "purpose": "Replace resource" },
    "PATCH": { "safe": false, "idempotent": false, "cacheable": false, "purpose": "Partial update" },
    "DELETE": { "safe": false, "idempotent": true, "cacheable": false, "purpose": "Delete resource" }
  },
  "statusCodeFamilies": {
    "1xx": "Informational",
    "2xx": "Success",
    "3xx": "Redirection",
    "4xx": "Client Error",
    "5xx": "Server Error"
  },
  "relatedSpecs": ["RFC 9110", "RFC 9112", "OpenAPI 3.1", "JSON:API", "HAL", "SIREN"]
}

Work with this as data

Every JSON Structure here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for json structure

4 MCP tools reach this
  • find_json_structuresBrowse and filter every JSON Structure in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools

Call it yourself

curl for this page
This JSON Structure 
curl "https://apis.io/api/v1/json-structures/rest-architecture-structure"
All json structure 
curl "https://apis.io/api/v1/json-structures?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.