Arquitectura Básico

API

Interfaz de Programación de Aplicaciones. Conjunto de reglas y protocolos que permite a diferentes sistemas de software comunicarse entre sí.

Pronunciación

/ˌeɪ.piːˈaɪ/
"a-pi-ai"
Escuchar en: Forvo Cambridge

Qué es

API significa Application Programming Interface (Interfaz de Programación de Aplicaciones). Es el conjunto de reglas que define cómo dos aplicaciones pueden hablar entre sí.

Piénsalo como un contrato entre sistemas: “si me preguntas esto de esta forma, te responderé con esto otro”.

Analogía del mesero

La analogía más usada (y la más clara):

Estás en un restaurante. Tú eres el cliente (tu aplicación). La cocina es el servidor (base de datos o sistema externo). El mesero es la API — toma tu pedido en un formato estándar, lo lleva a la cocina, y te trae la respuesta.

Tú no necesitas saber cómo funciona la cocina. Solo necesitas saber cómo hablarle al mesero.

Tipos de APIs más comunes

TipoDescripciónEjemplo de uso
RESTEl estándar actual. Usa URLs y HTTPLa mayoría de apps web
GraphQLPermite pedir exactamente lo que necesitasDashboards complejos
SOAPProtocolo XML más antiguoSistemas empresariales legacy
WebSocketComunicación en tiempo realChats, notificaciones live

Cómo funciona una petición API

Tu app → [GET /usuarios/123] → Servidor API

Tu app ← [{ id: 123, nombre: "Ana" }] ← Base de datos
  1. Tu app hace una petición con un método (GET, POST, PUT, DELETE)
  2. El servidor procesa la petición y consulta los datos
  3. El servidor responde con los datos en formato JSON o XML

APIs en el mundo real

Cuando usas servicios cotidianos, hay APIs trabajando detrás:

  • “Pagar con PayPal” en una tienda → API de PayPal
  • “Iniciar sesión con Google” → API de OAuth de Google
  • Mapa integrado en un sitio web → API de Google Maps
  • Notificaciones push en tu celular → API de Firebase

Por qué importa para tu empresa

Si tu empresa evalúa software en 2026, las APIs son el factor que determina si los sistemas pueden crecer y conectarse:

✅ Sistema con buena API:

  • Puede conectarse a tu CRM, ERP o sistema de pagos existente
  • Permite construir apps móviles o portales web sobre él
  • Se integra con herramientas futuras sin reescribir todo

❌ Sistema sin API (o con API mal diseñada):

  • Es una isla. Datos atrapados adentro
  • Cada integración requiere trabajo costoso y frágil
  • Difícil de escalar o adaptar a nuevas necesidades

Seguridad en APIs

Las APIs bien diseñadas incluyen mecanismos de seguridad:

  • API Key: contraseña única por cliente (quién puede llamar)
  • JWT / OAuth: tokens que verifican identidad y permisos
  • Rate Limiting: límite de peticiones por minuto (previene abuso)
  • HTTPS: encriptación del canal de comunicación

Términos relacionados

  • [[REST]] - El estilo arquitectónico más popular para diseñar APIs
  • [[Endpoint]] - La URL específica donde vive un recurso de la API
  • [[JWT]] - Formato de token para autenticar peticiones
  • [[Microservices]] - Arquitectura donde cada servicio expone su propia API

Recursos adicionales: