Una API es una puerta entre programas. En lugar de que una persona pulse botones en una pantalla, un programa envía una petición con una forma acordada y otro programa responde con una forma acordada. La palabra clave es interfaz: describe qué puedes pedir y qué recibes a cambio, no cómo se produce la respuesta.

Las siglas significan Application Programming Interface. Se usan para todo, desde las funciones que ofrece un lenguaje de programación hasta los servicios web que las empresas abren a sus clientes. Esta entrada trata del segundo tipo, la API web.

Cómo es una API web

Una API web funciona sobre el mismo protocolo que los sitios web, HTTP. Un programa envía una petición a una dirección y recibe una respuesta, casi siempre escrita en JSON, un formato de texto sencillo para datos estructurados. El ejemplo de abajo solo ilustra la forma.

GET /api/sites HTTP/1.1
Authorization: Bearer YOUR_KEY

200 OK
{"sites": [{"name": "Shop", "status": "up"}]}

La petición indica qué se quiere (la dirección y el método) y demuestra quién pregunta (la clave). La respuesta lleva un código de estado que dice si salió bien. En códigos de estado HTTP puedes ver qué significan esos números.

Para qué se usa una API

  • Leer datos y llevarlos a otra herramienta, como un informe, una hoja de cálculo o un panel.
  • Conectar servicios, de modo que un suceso en uno inicie una acción en otro.
  • Automatizar: un script hace según un horario lo que una persona haría a mano.
  • Construir sobre un servicio: una empresa crea su propia aplicación sobre datos que no guarda ella misma.

Solo lectura y lectura y escritura

Una API puede dejarte solo mirar, o también cambiar cosas. Una API de solo lectura puede mostrar datos, pero no crear, editar ni borrar nada. Si se filtra una clave de solo lectura, puede filtrarse información, pero la cuenta no se puede dañar. Una API de lectura y escritura es más potente y exige más cuidado con quién tiene la clave.

Malentendidos frecuentes

  • «Una API es lo mismo que un sitio web.» Un sitio web está hecho para que lo lean personas. Una API está hecha para programas y normalmente no tiene páginas.
  • «Una clave es lo mismo que una contraseña.» Una clave identifica a un programa y fija lo que puede hacer. Hay que guardarla en secreto como una contraseña, pero suele crearse para un solo uso, de modo que se pueda revocar sin tocar nada más.
  • «Toda API es REST.» REST es un estilo de API web. Muchas APIs se llaman REST pero siguen solo parte de sus reglas, y otras usan estilos distintos.

Las API y la monitorización

La monitorización y las API se encuentran en dos puntos. Un monitor puede comprobar que una API responde bien y con rapidez, porque una API rota estropea todo lo que se apoya en ella. Y un servicio de monitorización puede ofrecer su propia API, para que leas sus resultados en otras herramientas.

UptimeWire tiene una API de solo lectura en los planes Business y Agency. Con ella tus propias herramientas pueden leer los datos de monitorización de tu cuenta. No puede cambiar nada en la cuenta, y sus claves son distintas de las claves de la conexión MCP para asistentes de IA.