API REST
Estilo de arquitectura de API que usa los métodos y códigos del propio HTTP para operar sobre recursos identificados por URL, sin guardar estado entre llamadas.
También conocido como: api rest · api restful · rest api · restful · arquitectura rest
Prueba CRPRO gratis por 7 díasREST (Representational State Transfer) es un estilo de arquitectura para APIs. Una API que sigue ese estilo se llama RESTful. La idea central: todo es un recurso con dirección propia, manipulado por los verbos que el HTTP ya ofrece.
Los métodos
| Método | Qué hace |
|---|---|
| GET | busca datos, sin cambiar nada |
| POST | crea un recurso nuevo |
| PUT / PATCH | actualiza un recurso existente (completo / en parte) |
| DELETE | elimina |
Así, GET /contactos/42 busca el contacto 42 y DELETE /contactos/42 lo elimina. La dirección dice qué; el método dice la acción.
Los códigos de estado que vas a encontrar
- 2xx — salió bien (200 ok, 201 creado).
- 4xx — el error fue de quien pidió: 401 sin credencial, 403 sin permiso, 404 no existe, 429 superó el rate limit.
- 5xx — el error fue del servidor. Aquí repetir la llamada suele tener sentido; en 4xx, no.
Sin estado — y por qué importa
REST es stateless: cada llamada lleva todo lo que necesita y el servidor no guarda memoria entre una y otra. Eso simplifica la escala, pero significa que la autenticación va en cada solicitud.
REST, SOAP y GraphQL
- SOAP — más antiguo, basado en XML, más rígido y verboso. Todavía común en bancos y sistemas heredados.
- GraphQL — el cliente describe exactamente los campos que quiere, en una sola llamada. Evita traer datos de más.
- REST — el estándar dominante en integraciones web, incluida la API de WhatsApp.
Preguntas frecuentes
¿Cuál es la diferencia entre API y API REST?
API es el concepto general de interfaz entre sistemas. REST es un estilo de arquitectura específico, que usa los métodos y códigos del HTTP y trata cada dato como un recurso con dirección propia.
¿Qué significa RESTful?
Es el adjetivo para una API que sigue los principios REST: recursos identificados por URL, verbos HTTP para las acciones y comunicación sin estado entre llamadas.
¿Qué significa el error 429?
Too Many Requests: superaste el límite de llamadas permitido en el período. La solución es reducir la frecuencia y respetar el intervalo indicado en la respuesta, no repetir de inmediato.
¿Cuándo usar GraphQL en vez de REST?
Cuando el cliente necesita combinaciones variables de campos y el exceso de datos transferidos se vuelve un problema. Para integraciones simples y predecibles, REST suele ser más directo de operar.
Páginas relacionadas
Términos relacionados en el glosario
API
Interfaz que permite que dos sistemas intercambien datos y comandos entre sí, sin que uno necesite conocer el funcionamiento interno del otro.
Webhook (WhatsApp Business)
El webhook de WhatsApp es la dirección HTTPS que recibe de Meta, en tiempo real, los eventos del número: mensaje nuevo, estado de entrega, plantillas y alertas.
Conexión en la nube de WhatsApp
La Cloud API de WhatsApp (conexión en la nube) es la versión de la API oficial alojada por la propia Meta, sin servidor propio de la empresa.
Latencia
Tiempo transcurrido entre enviar una solicitud y recibir el comienzo de la respuesta, medido en milisegundos y percibido por el usuario como demora.