Introducción a APIs

¿Por qué son importantes las APIs?

Las APIs son el pegamento que une el mundo digital. Permiten que diferentes aplicaciones se comuniquen entre sí, habilitando la automatización moderna. Sin APIs, cada sistema sería una isla aislada.

¿Qué es una API? Explicado Simple

¿Qué es una API?

Definición Simple

🍽️ Analogía del Restaurante

👤

Cliente (Tu App)

Quiere ordenar comida

→

📋

Mesero (API)

Toma la orden y la lleva

→

👨‍🍳

Cocina (Servidor)

Prepara la comida

→

🍕

Respuesta

Comida servida

En términos técnicos: Una API (Application Programming Interface) es un conjunto de reglas y protocolos que permite que diferentes aplicaciones se comuniquen entre sí.

¿Cómo Funciona una API?

El Proceso Paso a Paso

1. Cliente hace una petición (Request)

GET https://api.ejemplo.com/usuarios/123
Headers:
  Authorization: Bearer tu-token-aqui
  Content-Type: application/json

2. Servidor procesa la petición

Valida autorización
Busca la información
Prepara la respuesta

3. Servidor envía respuesta (Response)

{
  "id": 123,
  "nombre": "Juan Pérez",
  "email": "juan@ejemplo.com",
  "rol": "administrador"
}

Componentes Clave:

🔗 Endpoint

URL específica donde está disponible un recurso

https://api.ejemplo.com/usuarios

📨 Request

Petición que envías a la API

GET, POST, PUT, DELETE

📬 Response

Respuesta que recibes de la API

JSON, XML, HTML

🔑 Authentication

Credenciales para acceder

API Key, OAuth, JWT

Tipos de APIs

Clasificación de APIs

Tipo	Descripción	Ejemplo	Uso
APIs Públicas	Abiertas para cualquier desarrollador	Twitter API, GitHub API	Integrar funcionalidades externas
APIs Privadas	Solo para uso interno de la empresa	API interna de inventario	Conectar sistemas internos
APIs Partner	Para socios comerciales específicos	API de Booking para hoteles	Integraciones B2B
APIs Composite	Combinan múltiples servicios	API de checkout e-commerce	Operaciones complejas

REST API - El Estándar Moderno

Principios REST

1. Cliente-Servidor

Separación de responsabilidades

2. Sin Estado (Stateless)

Cada petición es independiente

3. Cacheable

Las respuestas pueden almacenarse

4. Interface Uniforme

Uso consistente de métodos HTTP

Métodos HTTP en REST:

GET

Obtener datos GET /api/usuarios

Lista todos los usuarios

POST

Crear nuevo recurso POST /api/usuarios

Crea un nuevo usuario

PUT

Actualizar completo PUT /api/usuarios/123

Actualiza todo el usuario

PATCH

Actualizar parcial PATCH /api/usuarios/123

Actualiza campos específicos

DELETE

Eliminar recurso DELETE /api/usuarios/123

Elimina el usuario

Ejemplos Prácticos de APIs

APIs Populares para Agencias

Facebook Graph API

Uso: Gestión de campañas, análisis de audiencia

// Obtener insights de una página
GET /v12.0/{page-id}/insights?
  metric=page_views_total,page_fan_adds

Google Analytics API

Uso: Reportes automatizados de tráfico

// Obtener usuarios activos
{
  "dimensions": [{"name": "date"}],
  "metrics": [{"name": "activeUsers"}],
  "dateRanges": [{"startDate": "7daysAgo"}]
}

Mailchimp API

Uso: Email marketing automatizado

// Agregar suscriptor a lista
POST /lists/{list_id}/members
{
  "email_address": "user@example.com",
  "status": "subscribed"
}

Tutorial: Tu Primera Llamada a API

Herramientas para Trabajar con APIs

Kit de Herramientas Esencial

Postman

Para qué: Probar y documentar APIs

Interface visual amigable
Colecciones compartibles
Testing automatizado

Probar Gratis

Insomnia

Para qué: Cliente REST simple y potente

Open source
Diseño minimalista
GraphQL support

Descargar

RapidAPI

Para qué: Marketplace de APIs

Miles de APIs en un lugar
Testing integrado
Pricing unificado

Explorar

Seguridad en APIs

Nunca expongas API keys en código público
Usa HTTPS siempre
Implementa rate limiting
Valida todos los inputs
Usa tokens con expiración

Ejercicio Práctico

Tu Primera Llamada a API

Vamos a hacer una llamada real a una API pública:

1. API de Chistes (no requiere autenticación)

GET https://official-joke-api.appspot.com/random_joke

2. Prueba en tu navegador

Copia y pega la URL en tu navegador. Verás algo como:

{
  "type": "general",
  "setup": "Why did the scarecrow win an award?",
  "punchline": "Because he was outstanding in his field!",
  "id": 1
}

3. Prueba con JavaScript

fetch('https://official-joke-api.appspot.com/random_joke')
  .then(response => response.json())
  .then(data => {
    console.log(data.setup);
    console.log(data.punchline);
  });

Siguiente: Casos de Uso de APIs