Las claves verificadas
- Una API es un contrato que permite a un programa interactuar con otro software o hardware. Ver evidencia
- OpenAPI describe interfaces HTTP sin depender de un lenguaje de programación específico. Ver evidencia
- Una solicitud HTTP combina método, destino, encabezados y, cuando corresponde, contenido. Ver evidencia
- Los códigos de estado HTTP expresan el resultado general de una solicitud. Ver evidencia
Qué es una API y qué define su contrato
Una API, o interfaz de programación de aplicaciones, es un conjunto de reglas y funciones que permite a un programa interactuar con otro componente de software. La interfaz expone operaciones conocidas y oculta la implementación interna: quien la consume necesita entender el contrato, no el código que resuelve cada tarea.
También puede servirte: Qué es WebAssembly y para qué sirve en una web
Ese contrato puede incluir nombres de funciones, rutas, parámetros, formatos de datos, autenticación y posibles errores. Hay API dentro del navegador, en bibliotecas del sistema y en servicios remotos. Por eso, una API no es sinónimo de sitio web, base de datos ni servidor público.
El recorrido de una solicitud y una respuesta
En una API HTTP, el cliente envía una solicitud a una dirección con un método como GET o POST, encabezados y, cuando corresponde, un cuerpo. El servidor procesa la operación y devuelve una respuesta con un código de estado, encabezados y datos que suelen viajar en JSON.
El código 200 indica que la solicitud tuvo éxito; otros códigos describen redirecciones, errores del cliente o fallas del servidor. El significado depende también del método y del contrato publicado. Una clave de acceso identifica o autoriza al consumidor, pero debe mantenerse fuera del código público.
Guía visual para leer una API antes de integrarla
Primero identificá la operación que necesitás y revisá su documentación: ruta, método, campos obligatorios, ejemplo de respuesta, autenticación y límites. Después probá una solicitud mínima, registrá el código de estado y validá la estructura recibida antes de conectar el resultado con el resto de la aplicación.
OpenAPI permite describir una API HTTP en un documento legible por personas y herramientas. Esa descripción puede alimentar documentación, clientes, servidores y pruebas. Aun así, una especificación no garantiza disponibilidad ni calidad: conviene manejar demoras, reintentos seguros, cambios de versión y errores inesperados.
Qué aporta VisteEsto: Nuestro trabajo en esta nota
VisteEsto convierte la definición de API en un recorrido de solicitud y una guía práctica para leer un contrato antes de integrarlo.
Fuentes, actualizaciones y metodología 3 fuentes
Fuentes consultadas
- Fuente secundariaMDN: API — Glossary
- Fuente primariaOpenAPI Specification 3.0.4
- Fuente primariaRFC 9110: HTTP Semantics
Historial de actualización
- Publicación inicial basada en MDN, OpenAPI Initiative y RFC 9110.
Cómo elaboramos esta nota
Definimos la consulta principal “qué es una API y cómo funciona”, contrastamos los datos con 3 fuentes —2 primarias— y revisamos contexto, imágenes y posibles vacíos antes de publicar. Conocé nuestra política editorial y de verificación.
