Fundamentos de APIs

¿Qué es una API?

Una API (Interfaz de Programación de Aplicaciones) es un conjunto de reglas y protocolos que permite que diferentes aplicaciones de software se comuniquen entre sí. Piensa en ella como un mesero en un restaurante: tú (el cliente) le dices al mesero (la API) lo que quieres, y el mesero trae tu pedido desde la cocina (el servidor).

Las APIs están en todas partes en el desarrollo de software moderno. Cuando consultas el clima en tu teléfono, publicas en redes sociales o realizas un pago en línea, estás usando APIs detrás de escena.

Tipos de APIs

Arquitecturas de API Web

// Ejemplo de API REST
GET /api/users/123        // Obtener usuario 123
POST /api/users           // Crear nuevo usuario
PUT /api/users/123        // Actualizar usuario 123
DELETE /api/users/123     // Eliminar usuario 123

// Ejemplo de consulta GraphQL
query {
  user(id: 123) {
    name
    email
    posts {
      title
    }
  }
}

// Ejemplo de WebSocket
const socket = new WebSocket('wss://api.example.com/ws');

socket.onmessage = (event) => {
  console.log('Recibido:', event.data);
};

socket.send('¡Hola Servidor!');

Ciclo de Petición/Respuesta HTTP

Cada llamada a la API sigue un patrón de petición/respuesta:

// Estructura de Petición HTTP
{
  method: "GET",                    // Método HTTP
  url: "https://api.example.com/users",  // URL del Endpoint
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer token123"
  },
  body: {                           // Para POST/PUT/PATCH
    "name": "Juan Pérez",
    "email": "juan@example.com"
  }
}

// Estructura de Respuesta HTTP
{
  status: 200,                      // Código de Estado
  statusText: "OK",                 // Mensaje de Estado
  headers: {
    "Content-Type": "application/json",
    "X-RateLimit-Remaining": "99"
  },
  body: {                           // Datos de Respuesta
    "id": 123,
    "name": "Juan Pérez",
    "email": "juan@example.com"
  }
}

Métodos HTTP

Tu Primera Llamada a la API

Hagamos una llamada real a la API usando la Fetch API de JavaScript:

// Obteniendo datos desde una API pública
async function getUsers() {
  try {
    // Hacer la petición a la API
    const response = await fetch('https://jsonplaceholder.typicode.com/users');
    
    // Verificar si la petición fue exitosa
    if (!response.ok) {
      throw new Error(`¡Error HTTP! estado: ${response.status}`);
    }
    
    // Parsear respuesta JSON
    const users = await response.json();
    
    // Usar los datos
    console.log('Usuarios:', users);
    
    // Mostrar primer usuario
    users.forEach(user => {
      console.log(`- ${user.name} (${user.email})`);
    });
    
    return users;
  } catch (error) {
    console.error('Error al obtener usuarios:', error);
  }
}

// Llamar a la función
getUsers();

/*
Salida:
Usuarios: [{id: 1, name: "Leanne Graham", ...}, ...]
- Leanne Graham (Sincere@april.biz)
- Ervin Howell (Shanna@melissa.tv)
...
*/

Términos Comunes de API