Qué son las APIs y cómo funcionan

Aprende, paso a paso, cómo una API permite que dos computadores se comuniquen mediante HTTP y JSON. Verás cómo automatizar tareas, estructurar datos con listas y objetos anidados, y operar recursos con métodos como GET, POST, DELETE, PUT y PATCH. Ejemplos como la API de Facebook y Stripe ilustran su impacto en la vida real.

¿Qué es una API y por qué es clave en desarrollo web?

Una API es una interfaz creada por desarrolladores para que dos computadores “hablen” entre sí. Un servidor recibe un request y responde con un response específico. Esta comunicación también puede ser entre servidores para consultar datos que se requieren.

• Automatiza tareas repetitivas y masivas. Por ejemplo: crear mil facturas con un solo proceso automatizado.
• Conecta servicios que usas a diario. La API de Facebook usa la cookie de tu búsqueda para mostrarte publicidad relevante.
• Integra pagos seguros. Stripe permite guardar tarjetas de crédito cumpliendo estándares de seguridad sin que tú tengas que implementarlos en tu servidor.
• Acelera el desarrollo: crea, borra u obtiene información sin intervención manual.

¿Cómo fluye la comunicación request/response?

• Envías un request a un servidor mediante una API.
• Recibes un response con datos o confirmaciones en JSON.
• También puede ser servidor a servidor para obtener información requerida.

¿Qué ganamos con la automatización?

• Menos trabajo manual y menos errores.
• Procesos consistentes y repetibles.
• Escalabilidad para manejar grandes volúmenes de operaciones.

¿Cómo se estructura la información con JSON?

El formato JSON organiza datos de forma estructurada para compartirlos entre servidores o entre un servidor y un front end. Permite texto, listas (arrays) y objetos anidados.

• Campos entre comillas dobles y separados por comas.
• Sin coma al final del último campo.
• Listas para múltiples valores (por ejemplo, hobbies).
• Objetos anidados para datos relacionados (por ejemplo, contacto con email y redes sociales).

¿Cómo luce un usuario en JSON válido?

{
  "nombre": "Luis",
  "apellido": "Martínez",
  "hobbies": ["viajar", "programar", "enseñar"],
  "contacto": {
    "email": "luis@example.com",
    "redes_sociales": ["twitter", "github"]
  }
}

¿Qué herramientas ayudan a validar?

• Un editor como Visual Studio Code detecta y colorea JSON.
• Validadores en línea: busca “validar JSON” para confirmar que sea válido.

¿Cómo opera REST con métodos HTTP sobre recursos?

La arquitectura REST define reglas para enviar mensajes con HTTP y JSON. Se busca que las operaciones sean idempotentes (que “siempre pase lo mismo” con el mismo mensaje) y que exista una estructura clara y predecible. Un “usuario” es un recurso y su URL representa al recurso o a su lista.

¿Qué hace cada método sobre el recurso usuarios?

• GET /usuarios: obtiene la lista de usuarios.
• GET /usuarios/{id}: obtiene un usuario por su identificador único.
• POST /usuarios: crea un nuevo usuario enviando datos en JSON.
• DELETE /usuarios/{id}: intenta borrar un usuario y devuelve confirmación en JSON.
• PUT /usuarios/{id}: modifica todo el usuario.
• PATCH /usuarios/{id}: modifica un campo específico.

¿Qué comportamiento se espera al consultar o borrar?

• Se menciona que una API Rest puede permitir hacer GET o DELETE a cualquier identificador, exista o no, y responder en JSON indicando el resultado.
• La estructura consistente ayuda a trabajar en el entorno de desarrollo sin sorpresas.

¿Listo para practicar? Comparte en comentarios una lista de usuarios en JSON válida (usa un validador antes de pegarla).