REST API
API REST
Una API REST es una interfaz HTTP construida alrededor de recursos, como órdenes o usuarios. Cada solicitud es independiente, usa significados estándar de HTTP, puede soportar almacenamiento en caché y puede pasar a través de capas.
Otro ejemplo
Una aplicación de almacén obtiene `/orders/784`, cambia su dirección con un `PATCH` condicional y sigue un encabezado `Link` hasta el seguimiento. Cualquier servidor sin estado puede manejar la solicitud. Si el `ETag` es antiguo, el servidor devuelve 412 en lugar de reemplazar una edición más reciente.
Partes principales
- 01identificador de recurso
- 02Operación HTTP uniforme
- 03Representación y enlaces
Úsalo cuando
Use REST cuando HTTP basado en recursos, caching, capas intermedias y clientes que puedan cambiar por sí mismos se ajusten al producto.
No lo uses cuando
Una API no es RESTful solo porque envíe JSON sobre HTTP. Las sesiones con estado, los túneles de comandos RPC o ignorar los significados de HTTP son diseños distintos.
Nombre usado en código
client-server + stateless + cache + uniform interface + layered system + hypermedia Antes de lanzarlo
Check contracts and invariants, authorization, and input limits. Test retries, one-time effects, timeouts, and partial failures. Verify data integrity, compatibility, monitoring, recovery, and rollback.
Outcome: Complete the task with API REST (REST API). User context: Una aplicación de almacén obtiene `/orders/784`, cambia su dirección con un `PATCH` condicional y sigue un encabezado `Link` hasta el seguimiento. Cualquier servidor sin estado puede manejar la solicitud. Si el `ETag` es antiguo, el servidor devuelve 412 en lugar de reemplazar una edición más reciente. Technical concept or control: API REST (REST API). Why it fits: Use REST cuando HTTP basado en recursos, caching, capas intermedias y clientes que puedan cambiar por sí mismos se ajusten al producto. Do not use it when: Una API no es RESTful solo porque envíe JSON sobre HTTP. Las sesiones con estado, los túneles de comandos RPC o ignorar los significados de HTTP son diseños distintos. Engineering requirements: Define inputs, outputs, contracts, and rules that must always hold. Set authorization and input checks. Define failures, timeouts, retries, one-time effects, data moves, and compatibility limits. Operations: Add useful signals and logs that hide sensitive data. Set capacity limits and write an operator guide. Test recovery and rollback. Acceptance criteria: Contract and failure-path tests pass. Data and authorization rules still hold during retries and partial failures. Check performance limits, monitoring, recovery, and rollback. Evidence and limits (evidence boundary): Ningún estándar oficial único controla todo el término. Su significado puede cambiar según equipos, plataformas o marcos. Unknowns to confirm: Where the code runs, data stores, traffic shape, consistency needs, and the security boundary. Also confirm the compatibility period, service goals, and rollback limits.
Revisa esta petición
Review how API REST (REST API) is used now. Definition: Una API REST es una interfaz HTTP construida alrededor de recursos, como órdenes o usuarios. Cada solicitud es independiente, usa significados estándar de HTTP, puede soportar almacenamiento en caché y puede pasar a través de capas. Release checks: Check contracts and invariants, authorization, and input limits. Test retries, one-time effects, timeouts, and partial failures. Verify data integrity, compatibility, monitoring, recovery, and rollback. Before changing code, list the evidence, gaps, severity, and the smallest safe fix.