{"schema_version":"1.0","type":"Article","canonical_url":"https://visteesto.com/nota/que-es-api-como-funciona","machine_urls":{"markdown":"https://visteesto.com/ai/article/que-es-api-como-funciona/markdown","json":"https://visteesto.com/ai/article/que-es-api-como-funciona/json"},"publisher":{"name":"VisteEsto","url":"https://visteesto.com","editor":"Martín Rodríguez","editorial_policy":"https://visteesto.com/politica-editorial","corrections_policy":"https://visteesto.com/correcciones"},"headline":"Qué es una API y cómo conecta dos aplicaciones","description":"Qué es una API y cómo funciona: es un contrato que permite a dos programas intercambiar solicitudes y respuestas sin conocer su código interno.","dek":"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.","language":"es","section":"Tecnología","topic":"api-programacion","tags":["API","Programación","HTTP","Desarrollo web"],"author":{"name":"Martin Rodriguez","profile_url":"https://visteesto.com/autor/martin-rodriguez"},"date_published":"2026-09-17T12:00:00.000Z","date_modified":"2026-09-17T12:00:00.000Z","search_intent":"explain","content_format":"brief","primary_query":"qué es una API y cómo funciona","intended_audience":"Personas que empiezan a programar o necesitan entender cómo se conectan servicios y aplicaciones.","original_contribution":"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.","key_facts":[{"statement":"Una API es un contrato que permite a un programa interactuar con otro software o hardware.","evidence_url":"https://developer.mozilla.org/en-US/docs/Glossary/API"},{"statement":"OpenAPI describe interfaces HTTP sin depender de un lenguaje de programación específico.","evidence_url":"https://spec.openapis.org/oas/v3.0.4.html"},{"statement":"Una solicitud HTTP combina método, destino, encabezados y, cuando corresponde, contenido.","evidence_url":"https://www.rfc-editor.org/rfc/rfc9110"},{"statement":"Los códigos de estado HTTP expresan el resultado general de una solicitud.","evidence_url":"https://www.rfc-editor.org/rfc/rfc9110"}],"sections":[{"heading":"Qué es una API y qué define su contrato","paragraphs":["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."]},{"heading":"El recorrido de una solicitud y una respuesta","paragraphs":["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."]},{"heading":"Guía visual para leer una API antes de integrarla","paragraphs":["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."]}],"sources":[{"name":"MDN: API — Glossary","url":"https://developer.mozilla.org/en-US/docs/Glossary/API","kind":"secondary"},{"name":"OpenAPI Specification 3.0.4","url":"https://spec.openapis.org/oas/v3.0.4.html","kind":"primary"},{"name":"RFC 9110: HTTP Semantics","url":"https://www.rfc-editor.org/rfc/rfc9110","kind":"primary"}],"primary_source_gap":null,"images":[{"url":"https://visteesto.com/media/que-es-api-como-funciona/cover.jpg","alt":"Cliente y servidor conectados mediante una API","width":1200,"height":675,"creator":"VisteEsto","license":"VisteEsto editorial","licenseUrl":"https://visteesto.com/terminos","sourceUrl":"https://visteesto.com/que-es-api-como-funciona","caption":"La API define el contrato entre quien solicita datos y quien responde."},{"url":"https://visteesto.com/media/que-es-api-como-funciona/inline-1.jpg","alt":"Recorrido de una solicitud HTTP y su respuesta","width":1200,"height":800,"creator":"VisteEsto","license":"VisteEsto editorial","licenseUrl":"https://visteesto.com/terminos","sourceUrl":"https://visteesto.com/que-es-api-como-funciona","caption":"El cliente envía método, ruta y datos; el servidor devuelve estado y contenido."},{"url":"https://visteesto.com/media/que-es-api-como-funciona/inline-2.jpg","alt":"Elementos que hay que revisar en la documentación de una API","width":1200,"height":675,"creator":"VisteEsto","license":"VisteEsto editorial","licenseUrl":"https://visteesto.com/terminos","sourceUrl":"https://visteesto.com/que-es-api-como-funciona","caption":"Ruta, método, autenticación, datos y errores forman parte del contrato."}],"videos":[],"update_log":[{"date":"2026-09-17T12:00:00.000Z","note":"Publicación inicial basada en MDN, OpenAPI Initiative y RFC 9110."}],"citation_guidance":{"preferred_url":"https://visteesto.com/nota/que-es-api-como-funciona","include":["headline","author","date_published_or_modified","preferred_url"]}}