API REST
El estilo de API web más común: cada cosa tiene una URL y la manejás con verbos HTTP.
Una API REST es una API diseñada alrededor de una idea simple: todo lo que el sistema conoce es un recurso con su propia URL, y usás los verbos estándar de HTTP para actuar sobre él. GET /orders/42 lee el pedido 42, POST /orders crea uno nuevo, PUT /orders/42 lo reemplaza y DELETE /orders/42 lo borra. La respuesta suele volver en JSON.
El estilo lo describió Roy Fielding en su tesis doctoral del año 2000, y el nombre viene de REpresentational State Transfer (transferencia de estado representacional). Una de sus reglas es que cada pedido es stateless (sin estado): trae todo lo que el servidor necesita para responder, así que el servidor no tiene que acordarse de pedidos anteriores. Eso hace que las APIs REST sean fáciles de repartir entre muchos servidores y de cachear.
Cada respuesta trae además un código de estado, un número de tres cifras que dice cómo salió: 200 es OK, 201 creado, 404 no encontrado, 401 no iniciaste sesión, 500 falló el servidor. Como reusa lo que la web ya tiene, REST se volvió la forma por defecto en que apps, sitios y empresas se hablan entre sí. Cuando alguien dice "la API de Stripe" o "la API de GitHub", casi siempre habla de una API REST.
Para quedarse
- Cada cosa tiene una URL; el verbo HTTP dice qué hacer con ella.
- GET lee, POST crea, PUT o PATCH actualizan, DELETE borra.
- Los pedidos son stateless: cada uno se sostiene solo.
- Códigos de estado como 200, 404 y 500 te dicen cómo salió.
Para seguir leyendo
- ¿Qué es una API RESTful? (AWS)
- REST (glosario de MDN)
- Transferencia de Estado Representacional en Wikipedia
