¿Qué es API?

También llamado: Application Programming Interface, interfaz de programación de aplicaciones

Una API es un conjunto de reglas que permite a un programa pedir datos o acciones a otro. En la web, suele ser una serie de URL a las que una aplicación envía peticiones y de las que recibe respuestas en JSON.

Una API es como la carta de un restaurante: te dice qué puedes pedir y cómo, sin que tengas que saber qué pasa en la cocina. Cuando una tienda online calcula el envío con la tarifa de una empresa de transportes o cobra con una pasarela de pago, lo hace a través de sus APIs.

Ejemplo

Consultar una API desde la terminal:

$ curl -s https://api.example.com/v1/dominios/example.com \
    -H "Authorization: Bearer TU_TOKEN"
{"dominio":"example.com","caduca":"2027-08-13","renovacion_automatica":true}

La misma petición desde JavaScript:

const res = await fetch("https://api.example.com/v1/dominios/example.com", {
  headers: { Authorization: "Bearer TU_TOKEN" },
});
const datos = await res.json();

Estilos de API en la web

• REST — el más extendido: recursos con URL y métodos HTTP.
• GraphQL — una sola URL y el cliente pide exactamente los campos que quiere.
• Webhooks — al revés: es el servicio el que te avisa cuando pasa algo.

Cosas que conviene saber

• Las claves y los tokens de API son contraseñas. No los pongas en código JavaScript público ni los subas a un repositorio de Git; guárdalos en variables de entorno.
• Casi todas las APIs públicas tienen límites de uso (rate limits); si los superas, responden con un código 429.
• Versionar la API (/v1/, /v2/) permite cambiarla sin romper a quien ya la usa.

¿Tienes un producto o servicio relacionado con API? Anúnciate en este término.

Categorías: Backend