Conocimiento · TI · Datos · DX

API

Application Programming Interface

📂TI·datos·DX⏱Lectura de 2 min📊Introductorio🔗Relacionados 5

¿Qué es una API?

Definición en una línea
Interfaz de programación de aplicaciones (Application Programming Interface): un 'punto de conexión' por el que los programas intercambian datos y funciones según reglas definidas. Como el menú de un restaurante, es un acuerdo sobre qué pedir y cómo hacerlo.
Este tema, en capacitación interna📚 Curso relacionado💬 Consulta de capacitación
⚡ Resumen en 3 líneas
  • La 'ventanilla' por la que se comunican los programas
  • Acuerdo sobre qué pedir y cómo hacerlo
  • Lo básico de la conexión entre servicios

Lo que realmente cambia la API es la frontera entre «qué construimos nosotros» y «qué tomamos de otros». Funciones como mapas, pagos, envío de notificaciones por KakaoTalk, traducción o respuestas de IA, que antes requerían meses de trabajo de un equipo de desarrollo, se convierten en componentes que se integran la misma tarde en que uno se registra y obtiene una clave. Por eso, la pregunta en las reuniones de planificación cambia de «¿podemos construir esto?» a «¿de qué empresa tomamos esta función?».

En la práctica, las APIs se presentan de varias formas. La base es REST, que responde cuando le pedimos algo. También existe GraphQL, que permite pedir solo los campos necesarios, y, en sentido contrario, los webhooks (Webhook), que nos avisan cuando ocurre algo en el otro sistema. Para eventos cuyo momento no conocemos, como un pago completado o un envío que sale, conviene recibir un webhook en lugar de consultar cada 10 minutos. Antes de conectar hay que revisar tres cosas: el método de autenticación, el límite de llamadas y la unidad de cobro. Condiciones como '60 llamadas por minuto, 10.000 al mes gratis' pueden cambiar por completo el diseño más adelante.

También conviene aclarar los términos parecidos. El SDK es un paquete que envuelve esa API para usarla más cómodamente en cada lenguaje de programación. Un widget que incorpora también la pantalla completa es fácil de instalar, pero deja poco margen para adaptarlo a nuestra forma de trabajar. Una API no es solo lo que se trae de afuera: si se instala una API interna entre el sistema de pedidos y el de inventario, desaparecen los archivos de Excel que cada departamento se enviaba. En la fase de revisión, lo primero que se mira es si existen documentación y un entorno de pruebas (sandbox).

El error más frecuente es escribir la clave de API directamente en el código fuente o en documentos compartidos. Si alguien usa una clave filtrada para llamar a la IA desde nuestra cuenta, la factura llega a nosotros. El segundo es asumir que el servicio externo será eterno. Si una API externa se detiene 30 minutos, nuestro servicio también se detiene, y si se pasa por alto el aviso de fin de versión, una mañana la integración se corta por completo. No basta con diseñar la conexión: hay que definir también las reglas de reintento, las rutas alternativas y las alertas de uso.

Capacitaciones en las que aparece este término · IA·DX
Cursos recomendados · Instructores recomendados · Mini cotización
🧮 Mini cotización · Criterio de honorarios
Aprox. KRW 1,200,000 (≈ US$900)Charla especial de 2 horas · hasta 20 personas · en coreano
Solicitar cotización formal con estas condiciones →
💡 Dicho de forma sencilla
Como el menú de un restaurante: es un acuerdo del tipo «si pides así, obtienes esto».
Por qué es importante en la práctica
Hoy en día, casi todas las apps y servicios se construyen ensamblando varias APIs. Si entiende el concepto de API, sabrá qué conectar cuando le pida algo a la IA.
Origen y fuentes

El concepto de API existe desde los inicios del software. REST, hoy el estándar de facto de las APIs web, fue definido por Roy Fielding en su tesis doctoral de 2000.

Fuente · Roy Fielding, Arquitectura REST (2000) · Ver original
Entender con un caso

Veamos un caso hipotético: la empresa A, distribuidora de materiales de construcción e interiorismo, con 90 colaboradores y ventas anuales de KRW 24,000,000,000 (≈ US$17,963,300). Recibe más de 400 pedidos diarios en su tienda propia y en tres marketplaces, y cada mañana dos personas del equipo de atención al cliente descargaban un Excel de cada sitio y lo pasaban a mano al sistema de inventario. Esa tarea les tomaba 2 horas y 30 minutos al día, y como el inventario no era en tiempo real, se producían 3 envíos erróneos al mes por vender productos agotados.

  1. El jefe de sección Kim, de logística, encontró en el centro de vendedores de un marketplace la documentación de la 'API de consulta de pedidos' y lo dijo en la reunión: «Esto quiere decir que, en lugar de pulsar el botón de descarga, el sistema puede traer los datos solo.»
  2. En lugar de contratar el desarrollo, el coordinador Lee, del área interna de DX, trabajó durante 3 semanas y creó un script que trae cada 10 minutos los pedidos nuevos desde las APIs de pedidos de los tres marketplaces y los carga en la base de datos de inventario.
  3. En la segunda semana de pruebas se alcanzó el límite diario de 1.000 llamadas y los pedidos de la tarde se retrasaron 4 horas. El coordinador Lee dejó de consultar el catálogo completo y pasó al método de webhook, en el que el marketplace avisa primero cuando se genera un pedido.
  4. El responsable de seguridad de la información, el líder de equipo Park, vio que la clave de API estaba escrita en la hoja de cálculo compartida del equipo y frenó el proceso. «Esto es como dejar pegada en la pared la contraseña de la cuenta bancaria.» Se reemplazaron todas las claves y se trasladaron a las variables de entorno del servidor.
  5. Dos meses después de su puesta en marcha, las 2 horas y 30 minutos de carga manual se redujeron a 10 minutos diarios de revisión, y los envíos erróneos bajaron de 3 al mes a cero. Un integrante del equipo de atención al cliente pasó a dedicarse a la atención de consultas, y el tiempo de espera de respuesta se redujo de 12 a 4 minutos.
Términos relacionados
Capacitaciones relacionadas con este término
📚Transformación digitalCapacitación corporativa de Nanum Consultoría · presencial/en líneaVer curso →
¿Necesita capacitación interna sobre este tema?
Reciba de inmediato un currículo y una cotización personalizados para su equipo.
Consultar sobre capacitación
Última modificación 2026-09-13 · Revisado por John Kim

Preguntas frecuentes

Con mucha más frecuencia se trata de usar la API de otro. Cuando se abren a terceros funciones del propio servicio, se pasa a ser quien la «crea».
Es la forma (conjunto de reglas) más habitual de intercambiar APIs en la web. Maneja los recursos mediante la dirección (URL) y el método de solicitud.
Puede limitarse a enviar datos o también a crear servicios propios. Al integrar un servicio externo, lo que se hace es «usar» su API.
Es el método de API más extendido: una convención para intercambiar recursos a través de direcciones web (URL).