# Qué es una API y cómo conecta dos aplicaciones

> Una API define qué operaciones están disponibles, qué datos acepta y qué devuelve. En la web suele apoyarse en HTTP, pero API no significa necesariamente REST ni acceso público.

- URL canónica: https://visteesto.com/nota/que-es-api-como-funciona
- Autor: [Martin Rodriguez](https://visteesto.com/autor/martin-rodriguez)
- Publicado: 2026-09-17T12:00:00.000Z
- Actualizado: 2026-09-17T12:00:00.000Z
- Sección: Tecnología
- Tema: api-programacion
- Idioma: es
- Consulta principal: qué es una API y cómo funciona

## Resumen verificable

- Una API es un contrato que permite a un programa interactuar con otro software o hardware. ([evidencia](https://developer.mozilla.org/en-US/docs/Glossary/API))
- OpenAPI describe interfaces HTTP sin depender de un lenguaje de programación específico. ([evidencia](https://spec.openapis.org/oas/v3.0.4.html))
- Una solicitud HTTP combina método, destino, encabezados y, cuando corresponde, contenido. ([evidencia](https://www.rfc-editor.org/rfc/rfc9110))
- Los códigos de estado HTTP expresan el resultado general de una solicitud. ([evidencia](https://www.rfc-editor.org/rfc/rfc9110))

## Aporte editorial de VisteEsto

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.

## 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.

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.

## Fuentes consultadas

- Fuente secundaria: [MDN: API — Glossary](https://developer.mozilla.org/en-US/docs/Glossary/API)
- Fuente primaria: [OpenAPI Specification 3.0.4](https://spec.openapis.org/oas/v3.0.4.html)
- Fuente primaria: [RFC 9110: HTTP Semantics](https://www.rfc-editor.org/rfc/rfc9110)

## Imágenes y licencias

- Cliente y servidor conectados mediante una API. Autor: VisteEsto. Licencia: [VisteEsto editorial](https://visteesto.com/terminos). [Origen](https://visteesto.com/que-es-api-como-funciona).
- Recorrido de una solicitud HTTP y su respuesta. Autor: VisteEsto. Licencia: [VisteEsto editorial](https://visteesto.com/terminos). [Origen](https://visteesto.com/que-es-api-como-funciona).
- Elementos que hay que revisar en la documentación de una API. Autor: VisteEsto. Licencia: [VisteEsto editorial](https://visteesto.com/terminos). [Origen](https://visteesto.com/que-es-api-como-funciona).

## Cómo citar

Citar título, autor, fecha de publicación o actualización y la URL canónica. Las afirmaciones centrales incluyen su evidencia directa arriba. Esta versión Markdown es una representación accesible; la nota HTML canónica es la fuente editorial de referencia.