Cómo conectar una API a tu app: guía para principiantes

Qué es una API, cómo se lee una petición y una respuesta, cómo conectarla a tu app con fetch, dónde guardar la clave, cómo manejar errores y qué son los webhooks.

Publicado el 2026-10-02 · 4 min de lectura

En resumen

Una API es la forma en que un programa pide datos o acciones a otro: tu app envía una petición a una URL y recibe una respuesta, casi siempre en JSON.
Para conectarla necesitas la URL del endpoint, el método (GET, POST…), los parámetros y, a menudo, una clave.
Las claves secretas nunca van en el código del navegador: la llamada pasa por tu servidor.
Toda llamada puede fallar o tardar: muestra un estado de carga, maneja los errores y respeta los límites de uso.

Qué es una API

API significa interfaz de programación de aplicaciones. Es un acuerdo entre dos programas: «si me pides esto, de esta forma, te respondo esto otro». Cuando tu app muestra el clima, cobra con Stripe o envía un correo, está usando una API.

La mayoría de APIs web siguen el estilo REST: cada recurso tiene una URL (por ejemplo, /clientes/42) y se usan los métodos de HTTP para decir qué quieres hacer con él.

Anatomía de una petición y una respuesta

Una petición tiene:

URL o endpoint: a dónde llamas (https://api.ejemplo.com/v1/paises).
Método: GET para leer, POST para crear, PUT o PATCH para modificar, DELETE para borrar.
Cabeceras: información extra, como la clave de autenticación o el tipo de contenido.
Cuerpo: los datos que envías (en POST, PUT o PATCH), normalmente en JSON.

La respuesta trae un código de estado (200 todo bien, 201 creado, 400 petición incorrecta, 401 sin autenticar, 403 sin permiso, 404 no existe, 429 demasiadas peticiones, 500 error del servidor) y un cuerpo con los datos.

Tu primera llamada, paso a paso

Elige una API pública sin clave para practicar (hay listas recopiladas en GitHub con cientos de ellas: clima, países, libros, recetas).
Lee la documentación: qué endpoint, qué parámetros y qué devuelve.
Prueba la URL en el navegador o con una herramienta como Bruno, Postman o curl, y mira el JSON.
En tu app, haz la llamada con fetch (o pídele a tu asistente de IA que la escriba explicándote cada línea).
Muestra solo los campos que necesitas.
Añade el estado de carga y el manejo de errores.

Un buen prompt para la IA: «En este componente, llama a GET https://api.ejemplo.com/v1/paises con fetch, muestra «Cargando…» mientras llega, la lista de nombres cuando llegue y un mensaje amable si falla. No uses librerías nuevas».

Claves de API: dónde van

Muchas APIs piden una clave para saber quién llama y cobrar o limitar el uso. Si la pones en el código que corre en el navegador, cualquiera puede verla en las herramientas de desarrollador y usarla a tu costa.

Guarda la clave en una variable de entorno del servidor.
Crea un endpoint propio (por ejemplo, /api/clima) que llame a la API externa con la clave y devuelva solo lo necesario a tu frontend.
Si una clave se expone, revócala y crea otra.

Errores y límites

Comprueba el código de estado antes de usar los datos: fetch no lanza error con un 404 o un 500.
Pon un tiempo máximo de espera y un mensaje si la API tarda demasiado.
Respeta los límites de uso (rate limits). Si recibes un 429, espera antes de reintentar.
Guarda en caché lo que no cambia a cada segundo para no llamar de más.
Valida lo que llega: una API externa también puede devolver datos incompletos.

Webhooks: cuando la API te llama a ti

Con una API normal, tu app pregunta. Con un webhook, el otro servicio te avisa cuando pasa algo: Stripe cuando se cobra un pago, GitHub cuando alguien sube código. Tú expones una URL y el servicio envía allí los eventos.

Dos reglas: verifica la firma del webhook para asegurarte de que viene de quien dice venir, y prepárate para recibir el mismo evento más de una vez (procesarlo dos veces no debería cobrar o enviar dos veces).

Practica con APIs reales

La ruta APIs e integraciones de Codelindo cubre REST, peticiones y respuestas, autenticación, errores, webhooks e integraciones, con un minijuego de peticiones y retos. El proyecto final es una app publicada que trae datos reales de una API, maneja carga y errores, y guarda su clave donde debe. Está incluida en el plan Pro.

Preguntas frecuentes

¿Qué es un endpoint?

La URL concreta de una API a la que haces una petición, por ejemplo https://api.ejemplo.com/v1/paises.

¿Qué es JSON?

Un formato de texto para intercambiar datos, con pares clave-valor y listas. Es el formato más común en las APIs web.

¿Necesito un backend para usar una API?

Para APIs públicas sin clave, no. Para APIs con clave secreta, sí: la llamada debe pasar por tu servidor o por una función serverless.

¿Qué diferencia hay entre una API y un webhook?

Con una API, tu app pregunta cuando quiere. Con un webhook, el otro servicio te avisa cuando ocurre algo.

Siguiente paso: curso de APIs e integraciones.