Qué es realmente una API
La forma más clara de pensar en una es como un menú de solicitudes que un programa le ofrece a otro.
Un restaurante no te deja entrar a la cocina y cocinar. Te entrega un menú: aquí están las cosas que puedes pedir, así es como las pides, esto es lo que recibirás. No necesitas saber cómo funciona la cocina. Solo necesitas el menú. Una API es exactamente eso: una empresa dice "estas son las solicitudes que tienes permitido hacerle a nuestro servicio, y esto es lo que devuelve cada una".
Cuando la IA escribe código que "llama a la API del clima", está haciendo un pedido de ese menú: dame el pronóstico para esta ciudad. Los servidores de la empresa del clima hacen el trabajo y devuelven una respuesta. Tu aplicación nunca ve su ni su código. Solo recibe el plato.
┌────────────┐ request: GET /forecast?city=London ┌────────────┐
│ YOUR APP │ ─────────────────────────────────────▶ │ API │
│ (client) │ │ endpoint │
│ │ ◀───────────────────────────────────── │ (server) │
└────────────┘ response: { "temp": 14, ... } (JSON) └────────────┘
orders off does the work,
the menu sends the dish
El cambio de mentalidad importante: una API es un contrato. La otra empresa promete que si preguntas de una forma específica, obtendrás una respuesta con una forma específica. Tu trabajo —y el de la IA— es preguntar correctamente y leer la respuesta correctamente. La mayoría de los errores de API ocurren cuando un lado rompe ese contrato.