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).
