# ¿Qué es una API (y una clave de API)?

> Una API es un contrato estructurado de mensajería que permite al backend de tu aplicación pedir trabajo a otro servicio (como un proveedor de IA) por internet, y una clave de API es la contraseña privada que envía tu servidor para demostrar que tiene permiso.

## Analogía

Una API es como un albarán estándar entre la cocina de un hotel y un obrador de confianza: la cocina envía un pedido exacto («12 cruasanes sencillos») y recibe una caja etiquetada. La clave de API es el sello de la cuenta del hotel en ese albarán: quien robe ese sello puede hacer pedidos a tu cargo.

## Cómo funciona

Los programas no hacen clic en botones para hablar entre sí; usan una api (interfaz de programación de aplicaciones). El backend de tu app envía una **petición** segura por HTTPS con texto estructurado (JSON) a una dirección concreta —como `https://api.tokentide.app/v1`— y recibe una **respuesta** en JSON un instante después.

Como los servicios externos tienen un precio o manejan datos privados, exigen una api-key en cada petición. Por ejemplo, una clave de Tokentide empieza por `tt_live_` y se muestra una sola vez al crearla (puedes cargar saldo desde 10 USD). Quien tenga esa clave puede gastar tu saldo, por lo que siempre pones un tope de gasto diario y usas una clave aparte de límite bajo para el desarrollo en tu equipo.

Tu app lee cada clave de API desde una env-var —como `TOKENTIDE_API_KEY` o `AI_GATEWAY_API_KEY`— guardada únicamente en vercel (tipo **Secret**) y en el archivo `.env.local` de tu equipo. Tú pegas las claves directamente allí; nunca pegas una clave de API en el chat, en el código ni en GitHub.

Todas las llamadas a una API que usan una clave secret se hacen estrictamente desde el servidor (en Server Actions o Route Handlers de Next.js), nunca desde el navegador visitante. Si alguna vez sospechas que una clave se ha filtrado, la revocas al instante en la web del proveedor, creas una nueva y actualizas Vercel y `.env.local`.

## En tu proyecto

Cuando tu plan llega a una función con IA, tu agente prepara `.env.local` con las líneas `TOKENTIDE_API_KEY=` y `AI_GATEWAY_API_KEY=` vacías y te indica cómo pegar tus claves en VS Code y en los ajustes de Vercel. Después ejecuta `npm run check-env`, que solo comprueba si cada nombre está puesto o falta, sin mostrar jamás su valor.

## Copia para tu agente

```text
Comprueba qué API externas usa mi proyecto, confirma que todas las llamadas se ejecutan exclusivamente en el servidor y haz una comprobación que diga solo si los nombres de sus variables de entorno están puestos o faltan.
```

---
Fuente: [Agentic Makers](https://agenticmakers.app/es/aprende/que-es-una-api) · Licencia: CC BY 4.0