APIs (Application Programming Interfaces)

    Una API (Application Programming Interface) es como el mozo de un restaurante: vos pedís algo (por ejemplo, “dame los usuarios”) y la API va a la cocina (el servidor), trae lo que pediste y te lo entrega en bandeja (en formato JSON, generalmente).

    ¿Para qué sirve? Sirve para que dos aplicaciones distintas puedan comunicarse entre sí. En vez de que vos tengas que meterte en el código del otro sistema, le pedís los datos a través de su API. Por ejemplo: tu app puede usar la API de Google Maps para mostrar ubicaciones sin tener que reinventar el mapa.

    ¿Por qué conocer esto mejora tus habilidades como desarrollador? Porque hoy todo está conectado: tu backend habla con tu frontend, tu app con servicios externos, y hasta tu heladera con el servidor de la empresa. Entender cómo funcionan las APIs te convierte en un desarrollador capaz de integrar sistemas y ahorrar tiempo.

    Ejemplo simple:

    • Pedís una pizza (request)
    • Te traen la pizza (response)
    • Si pediste algo que no existe, te devuelven un error 404 (pizza no encontrada). Si la pizza existe te devuelve una pizza (en formato JSON, obvio)

    Concepto

    Una API (REST) define cómo un software puede interactuar con otro mediante endpoints, métodos HTTP, y formatos de datos estándar.

    Revisemos el siguiente ejemplo:

    import express from 'express';
const app = express();

app.use(express.json());

// Endpoint para obtener usuarios
app.get('/api/users', (req, res) => {
  res.json([{ id: 1, nombre: 'Diego' }, { id: 2, nombre: 'Pezet' }]);
});

// Endpoint para crear un usuario
app.post('/api/users', (req, res) => {
  const nuevoUsuario = req.body;
  res.status(201).json({ message: 'Usuario creado', data: nuevoUsuario });
});

app.listen(3000, () => console.log('API escuchando en http://localhost:3000'));

    En este sentido:

    • /api/users → es la ruta.
    • GET, POST, PUT, DELETE → son los métodos HTTP.
    • req y res → representan la solicitud y la respuesta.
    • Se intercambian datos en formato JSON.

    Conclusión

    Las APIs son el puente de comunicación entre sistemas.

    Entonces, si yo tengo mi API de mi sistema de, supongamos, un kiosko kiosko, el frontend (la caja registradora) no necesita saber cómo funciona la base de datos: solo le pide cosas a la API. “Mostrame los productos”, “registrame una venta”, “actualizame el stock”.

    Todo pasa por esa capa intermedia, que define la lógica de negocio.