REST API
REST APIs aprovechan los HTTP methods para gestionar recursos identificados por URIs, permitiendo web services escalables y flexibles.
REST APIs modelan aplicaciones como una colección de recursos identificados por URIs únicas. Los clientes interactúan con estos recursos utilizando un conjunto fijo de operaciones, comúnmente mapeadas a HTTP methods (GET, POST, PUT, PATCH, DELETE). Las constraints clave incluyen: statelessness (sin contexto de cliente en el lado del servidor entre requests), una uniform interface (métodos, URIs y media types estandarizados), client-server separation, cacheability, y un layered system. Las representations (típicamente JSON o XML) se transfieren sobre HTTP, y el content negotiation, versioning, y HATEOAS (opcionalmente) guían las interacciones del cliente. REST es un architectural style, no un protocol, y aunque se alinea bien con la web, el diseño RESTful práctico requiere balancear over-fetching, under-fetching, y security concerns como authentication, authorization, y transport security (TLS).
graph LR
Center["REST API"]:::main
Pre_http["http"]:::pre --> Center
click Pre_http "/terms/http"
Pre_api["api"]:::pre --> Center
click Pre_api "/terms/api"
Rel_apache_http_server["apache-http-server"]:::related -.-> Center
click Rel_apache_http_server "/terms/apache-http-server"
classDef main fill:#7c3aed,stroke:#8b5cf6,stroke-width:2px,color:white,font-weight:bold,rx:5,ry:5;
classDef pre fill:#0f172a,stroke:#3b82f6,color:#94a3b8,rx:5,ry:5;
classDef child fill:#0f172a,stroke:#10b981,color:#94a3b8,rx:5,ry:5;
classDef related fill:#0f172a,stroke:#8b5cf6,stroke-dasharray: 5 5,color:#94a3b8,rx:5,ry:5;
linkStyle default stroke:#4b5563,stroke-width:2px;
🧒 Explícalo como si tuviera 5 años
Como una máquina expendedora: eliges un producto (Recurso) y la máquina te lo da. No recuerda quién eres después (Stateless).
🤓 Expert Deep Dive
Ideado por Roy Fielding. Usa códigos de estado HTTP para indicar éxito o error. Soporta caché para mejorar el rendimiento.