Clicked Gallery

¿Qué es una API?

Subrayado en un documento técnico real. Explicado por Clicked.

Usado en una frase

Engineering Notes · AI Systems

The bank exposes account balances through a documented API rather than letting partners touch the database.

El lector subrayó una palabra en la documentación. Clicked hizo que el término técnico «API» fuera fácil de entender:

Explicado en tres niveles

Los mismos datos, otro rollo — Modo jerga 😎

El método Clicked

●○○

Overview

Una API, siglas de interfaz de programación de aplicaciones, es un conjunto de reglas que permite a distintas aplicaciones hablar entre sí e intercambiar datos. Un programa pregunta en un formato acordado y el otro responde en un formato acordado, sin que ninguno necesite saber cómo funciona el otro por dentro. Casi todo lo que en internet habla con algo lo hace a través de una API.
●○○

Overview

Una API es cómo un programa pide algo a otro sin que ninguno de los dos husmee en los asuntos del otro. Pregunta con la forma que quieren, recibe lo que prometieron y no te metas en el resto. Básicamente todo internet se sostiene con este único acuerdo, repetido unos cuantos miles de millones de veces por segundo. 😎

Una idea rápida — muchas veces es todo lo que necesitas.

●●○

Detail

Una API es una forma publicada de que un programa pida algo a otro: envía una petición con este formato y recibe una respuesta con aquel formato. Un servicio meteorológico puede prometer que si le envías el nombre de una ciudad, te devuelve el pronóstico de hoy. La aplicación que pregunta nunca necesita saber cómo se elaboró ese pronóstico, solo cómo pedirlo. Esa separación es justamente el objetivo, porque permite que ambas partes cambien de forma independiente. El servicio puede reconstruir su sistema entero sin romper todas las aplicaciones que lo usan, siempre que la API siga igual. El dueño decide además qué peticiones se admiten, quién puede hacerlas y con qué frecuencia. Si esas reglas cambian de forma incompatible, las aplicaciones antiguas dejan de funcionar, así que las empresas suelen publicar una versión nueva en lugar de alterar la anterior. Los sistemas de IA modernos se apoyan en APIs constantemente, para el tiempo, tu calendario o un vuelo.
●●○

Detail

Cada aplicación de tu móvil se pasa el día mendigando a otros programas cosas que no sabe hacer por su cuenta, y así es como funciona casi todo. Una web de precios de vuelos no posee ni un avión: le pregunta a cada aerolínea las tarifas de hoy, cose las respuestas y te entrega una lista ordenada como si hubiera hecho algo brillante. La aerolínea decide qué consultas atiende, de quién y cuántas antes de dejar de contestar. Nadie le manda a nadie su base de datos. Pregunta con la forma publicada, recibe la forma prometida, no entres en la cocina. Y cuando la forma tiene que cambiar, nadie edita la que está viva, porque eso rompe de golpe todas las aplicaciones que dependen de ella. Publican una segunda versión y dejan que la primera se retire con dignidad. 😎

¿Quieres más? Un clic profundiza.

●●●

Analogy

Una carta de restaurante. Enumera exactamente qué puedes pedir y qué llega si lo haces, y nunca ves la cocina, ni conoces al chef, ni aprendes la receta. La cocina puede cambiar de hornos o de proveedores sin decírtelo y tu pedido sigue funcionando, porque la carta es el acuerdo. Pide algo que no está en la carta y la respuesta es simplemente no.
Deepest level reached.
●●●

Analogy

Una máquina expendedora. Pulsas B4, salen las patatas y en ningún momento puedes meterte dentro a rebuscar. Pueden cambiar de proveedor, recablearla entera, reponerla del revés, y B4 sigue significando patatas. Pulsa un botón que no existe y no obtienes nada: ni patatas, ni explicación, ni devolución.
Deepest level reached.

¿Concepto nuevo? Un ejemplo cotidiano lo hace clic — nuevas analogías cuando quieras.

Las explicaciones de IA pueden contener errores · No es asesoramiento profesional

Definición formal — El mismo término, explicado de la forma habitual

Una API, o interfaz de programación de aplicaciones, es un contrato definido que especifica las peticiones que acepta un sistema de software y las respuestas que devuelve, permitiendo la interoperación sin exponer la implementación interna. Este desacoplamiento permite la evolución independiente de proveedor y consumidor, sujeta a disciplina de versionado, y constituye el límite donde se aplican la autenticación, la autorización y la limitación de peticiones.

¿Quieres que Clicked te explique términos como «API» directamente en tu navegador, incluso en PDFs?

Añadir a Chrome — Gratis

50 Explicaciones gratis · Sin tarjeta de crédito