Cómo funciona
Una API REST (Representational State Transfer) usa los verbos de HTTP (GET, POST, PUT, PATCH, DELETE) para operar sobre recursos identificados por URLs. Cada petición es independiente: el servidor no guarda el estado de la conversación entre llamadas, y toda la información necesaria va en la propia petición, en los encabezados o en el cuerpo. Las respuestas suelen venir en JSON, con códigos de estado HTTP que indican éxito (2xx) o error (4xx, 5xx). El estilo REST también valora la caché, la interfaz uniforme y la separación entre cliente y servidor.
Ejemplo práctico
Imagina una app de tareas. Para listar tareas, el cliente hace GET /tarefas. Para crear una, hace POST /tarefas con un JSON en el cuerpo. Para eliminar, hace DELETE /tarefas/42. El mismo patrón aplica a las APIs de IA: envías un POST con el prompt y recibes el texto generado en JSON. Los webhooks complementan este flujo enviando eventos de vuelta a tu sistema.
Para qué sirve
REST es el patrón más común para integrar sistemas, porque usa la infraestructura web ya existente, es fácil de probar en el navegador o con curl y funciona con cualquier lenguaje. Para quien construye agentes de IA, las APIs REST son el puente entre el modelo y herramientas externas, como bases de datos, sistemas de archivos y servicios de terceros. GraphQL ofrece una alternativa cuando el cliente necesita campos específicos.
Buenas prácticas
Usa nombres de recursos en plural, versiona la API, devuelve códigos de estado adecuados y documenta los endpoints. Esto facilita el mantenimiento y la integración por parte de otros desarrolladores y agentes.