Qué es una API y cómo conectarse a una por primera vez
API explicada sin complicaciones: qué es, cómo funcionan REST, JSON y las claves, y cómo hacer la primera llamada en el navegador, la terminal, Python y JavaScript.
Publicado el 18 de octubre de 2026 · 4 min de lectura
API es la sigla de Application Programming Interface, o interfaz de programación de aplicaciones. El nombre asusta, pero la idea es simple: una API es una forma acordada de que un programa le pida datos o acciones a otro. Cuando tu aplicación del banco muestra el saldo, cuando un sitio muestra el pronóstico del tiempo o cuando un bot publica un resultado en Telegram, casi siempre hay una API detrás. Esta guía explica los conceptos sin jerga y termina con vos haciendo tu primera llamada.
Una analogía que funciona
Pensá en un restaurante. No entrás a la cocina, le pedís al mozo por el menú, y él vuelve con el plato. La API es el mozo con el menú: define qué se puede pedir, cómo pedirlo y qué vuelve, y esconde toda la cocina. No necesitás saber cómo se recolectó el dato, solo cómo pedirlo.
Los términos que vas a ver
| Término | Qué es |
|---|---|
| Endpoint | Una dirección específica de la API, como /latest, que devuelve un tipo de dato |
| Petición | El pedido que tu programa le hace a un endpoint |
| Respuesta | Lo que la API devuelve, normalmente en JSON |
| JSON | Un formato de texto para datos, con claves y valores, que cualquier lenguaje entiende |
| Clave de API | Una contraseña que identifica quién está pidiendo y a qué puede acceder |
| Estado HTTP | Un número que dice cómo salió el pedido: 200 salió bien, 401 falta la clave, 429 demasiadas peticiones |
| Límite por minuto | Cuántas peticiones podés hacer en un minuto, según el plan |
Qué es una API REST
La mayoría de las APIs de internet son REST: hacés peticiones HTTP, las mismas que hace el navegador al abrir una página, a direcciones que representan los datos. Para leer datos se usa el método GET. La respuesta viene en JSON, y listo.
Un ejemplo de respuesta en JSON, de la API del Bac Bo Live de LynxMetrics:
{
"data": {
"id": "v1792354840763",
"outcome": "banker",
"settledAt": "2026-10-18T20:20:49.923Z",
"data": {
"player": { "dice": [1, 2], "score": 3 },
"banker": { "dice": [4, 5], "score": 9 },
"multiplier": null
}
}
}Incluso sin saber programar se puede leer: la ronda terminó a las 20:20 (en UTC), el Banker ganó 9 a 3, y no hubo empate.
Cómo conectarse a una API, paso a paso
- Leé la documentación. Dice la dirección base, los endpoints, los parámetros y cómo mandar la clave. En LynxMetrics, todo está en la documentación.
- Conseguí una clave. Normalmente creás la cuenta y generás la clave en un panel. En LynxMetrics, la prueba gratis de 2 horas ya te da una clave.
- Hacé la primera llamada. Usá la terminal o un programa como Postman o Insomnia, que muestran la respuesta formateada.
- Llevalo al código. Con la llamada funcionando, repetís lo mismo en el lenguaje de tu proyecto.
- Tratá los errores. Preparate para cuando la clave esté mal, se acabe el límite o se corte internet.
La primera llamada de cuatro formas
En la terminal, con curl, que ya viene en Windows, macOS y Linux:
curl https://api.lynxmetrics.com/v1/bacbo-live/latest \ -H "x-api-key: TU_CLAVE"
En Python:
import requests
r = requests.get("https://api.lynxmetrics.com/v1/bacbo-live/latest", headers={"x-api-key": "TU_CLAVE"})
print(r.status_code, r.json())En JavaScript, en Node.js:
const r = await fetch("https://api.lynxmetrics.com/v1/bacbo-live/latest", {
headers: { "x-api-key": "TU_CLAVE" },
});
console.log(r.status, await r.json());Sin ninguna clave, se puede ver una API pública directo en el navegador. Abrí api.lynxmetrics.com/v1/apis, que lista el catálogo de APIs de LynxMetrics con los planes y precios, y mirá cómo es un JSON de verdad.
Los errores más comunes
| Estado | Qué significa | Qué hacer |
|---|---|---|
| 401 | La clave no fue enviada, está mal o fue revocada | Revisá la cabecera y copiá la clave de nuevo en el panel |
| 403 | La clave existe, pero no tiene acceso a lo que pediste | Mirá si la clave es de la API correcta y si el plan está activo |
| 404 | La dirección no existe | Revisá el endpoint en la documentación |
| 429 | Demasiadas peticiones en poco tiempo | Esperá los segundos de la cabecera Retry-After |
| 500 a 504 | Error del lado de la API | Probá de nuevo en unos segundos |
En LynxMetrics, todo error viene con un código fijo y un mensaje, como {"error": {"code": "key_wrong_api", "message": "Esta clave es de otra API."}}. La lista completa está en la documentación.
Por qué usar una API en vez de copiar los datos de un sitio
Copiar datos de una página con un programa, el llamado raspado, funciona hasta que la página cambia. Una API es un contrato: el formato queda estable, los datos vienen completos y el proveedor se encarga de la recolección. Comparamos los dos caminos en raspar el sitio o usar una API.
Próximo paso
Si querés practicar con datos que cambian cada medio minuto, la API del Bac Bo Live es un buen laboratorio: la prueba es gratis, la respuesta es chica y el resultado cambia todo el tiempo, así que ves tu integración funcionando al instante.
Preguntas frecuentes
- ¿Qué es una API, de forma simple?
Es una forma acordada de que un programa le pida datos o acciones a otro. Hacés un pedido a una dirección y recibís la respuesta lista, normalmente en JSON, sin necesidad de abrir ninguna página.
- ¿Necesito saber programar para usar una API?
Para probarla, no: se puede llamar a una API desde el navegador, la terminal o programas como Postman. Para integrarla en un bot o un sitio, un poco de programación ayuda, pero los ejemplos suelen tener pocas líneas.
- ¿Qué es una clave de API?
Es una contraseña que identifica quién está haciendo el pedido y a qué puede acceder. Va en una cabecera del pedido y debe guardarse como cualquier contraseña.
Lee también
- Resultados en tiempo real: el stream SSE, evento por evento
Cómo recibir cada ronda en el instante en que se guarda: los eventos del /stream, la reconexión con Last-Event-ID y por qué SSE en vez de webhook o WebSocket.
- Dónde alojar un bot 24 horas: alojamiento, VPS o serverless
Qué necesita de verdad un bot que corre sin parar, cuánto cuesta cada opción de alojamiento, y por qué serverless no combina con una conexión abierta.
- Errores y límites de API: 429, backoff y qué hacer
Guía práctica de los errores de una API de datos: qué significa cada estado HTTP, cómo tratar el 429 con Retry-After y backoff, y el código que lo resuelve.