API

Una API define qué se puede pedir a un programa o servicio, cómo pedirlo y qué responderá. Las APIs web funcionan con peticiones HTTP y suelen responder en formato JSON.

Muchas exigen una clave para identificar a quién llama. Esa clave no debe escribirse en el código ni publicarse, porque da acceso a la cuenta.

Un ejemplo

Una app del tiempo no calcula la previsión: pide los datos a la API de un servicio meteorológico y los muestra.

Por qué importa

Las APIs son la razón por la que tantas aplicaciones pueden conectarse entre sí sin reinventarlo todo: pagar con una pasarela, mostrar un mapa, iniciar sesión con otra cuenta o consultar el tiempo. Un programador que sabe usar APIs ahorra mucho trabajo, porque reutiliza servicios que otros ya han construido.

En la práctica, usar una API implica leer su documentación, que explica las direcciones, los datos que se envían y el formato de la respuesta. También conviene tener en cuenta los límites de uso, que muchos servicios imponen, y manejar los errores: la API puede fallar, tardar o devolver datos distintos de los esperados.

Confusiones frecuentes

Se confunde la API con el programa o con el servidor que hay detrás. La API es solo la «puerta»: la lista de lo que se puede pedir y cómo. Tampoco todas las APIs son web: una biblioteca de programación también ofrece una API a quien la usa. Y que una API sea pública no significa que sea gratuita ni que no necesite clave.

Preguntas frecuentes

¿Qué hago si publiqué mi clave de API por error?

Revócala o regenérala desde el panel del servicio de inmediato, porque cualquiera podría usarla a tu nombre. Después sustitúyela y no la guardes en el código.

¿Cómo pruebo una API sin programar?

Con una herramienta como Postman, o con curl desde la terminal, puedes enviar una petición y ver la respuesta antes de escribir código.