Las APIs son interfaces que permiten a los computadores comunicarse entre sí usando una estructura definida por desarrolladores. Si trabajas en desarrollo web moderno, entender cómo funcionan las APIs REST y el formato JSON es la base para automatizar procesos, integrar servicios externos y enviar información entre servidores y clientes.
¿Qué es una API y para qué sirve en desarrollo web?
Una API funciona como un puente entre dos sistemas. Tú envías un request a un servidor y ese servidor te devuelve una respuesta específica. Esa misma lógica se aplica entre servidor y servidor cuando uno necesita datos del otro.
La potencia está en la automatización. Imagina que tienes 1.000 suscriptores y necesitas generar una factura para cada uno. En lugar de crearlas manualmente, un solo request a la API genera las 1.000 facturas en segundos [01:08].
¿Para qué sirve una API? Sirve para que dos sistemas se comuniquen automáticamente, intercambien datos y ejecuten acciones sin intervención manual, usando un formato estructurado.
¿Qué APIs uso todos los días sin darme cuenta?
Probablemente interactúas con varias APIs sin notarlo. Algunas que ya forman parte de tu día a día son:
- API de Facebook: captura tu cookie de búsqueda y la usa para mostrarte publicidad personalizada en otros sitios.
- API de Stripe: permite guardar tarjetas de crédito de forma segura sin que tu servidor tenga que cumplir todos los estándares de seguridad.
- APIs de pago en general: integran cobros dentro de tu sitio web sin que construyas la infraestructura desde cero.
Esto explica por qué las APIs son tan importantes: te ahorran trabajo, complejidad técnica y responsabilidad de seguridad.
¿Qué es JSON y cómo se estructura un mensaje de API?
Las APIs se comunican usando el formato JSON, que organiza la información de forma estructurada para compartirla entre servidores o entre un servidor y un frontend [02:44].
Un JSON puede guardar:
- Texto simple, como un nombre.
- Arreglos o arrays, por ejemplo una lista de profesiones de un usuario.
- Objetos anidados, como la información de contacto dentro del objeto usuario.
¿Cómo escribir un JSON válido paso a paso?
Si abres Visual Studio Code y creas un archivo JSON, la estructura básica empieza con llaves {} para objetos o corchetes [] para arreglos [03:42]. Cada campo va entre comillas dobles, seguido de dos puntos y su valor.
{
"nombre": "Luis",
"apellido": "Martínez",
"hobbies": ["viajar", "programar", "enseñar"],
"contacto": {
"email": "luis@ejemplo.com",
"redes_sociales": "@luis"
}
}
Las reglas clave que debes recordar:
- Usa coma para separar campos, pero nunca después del último.
- Las comillas dobles son obligatorias en claves y valores de texto.
- Puedes anidar objetos dentro de objetos para agrupar información relacionada.
Un truco útil: busca en Google validar JSON y vas a encontrar herramientas que te confirman si tu sintaxis es correcta antes de enviarla.
¿Qué es JSON? Es un formato de texto estructurado que usan las APIs para intercambiar información. Permite guardar texto, listas y objetos anidados de forma que humanos y máquinas pueden leerlo fácilmente.
¿Qué es REST y cómo funcionan sus métodos HTTP?
Más allá de JSON, existe una arquitectura llamada REST que define cómo enviar esos mensajes [05:20]. REST combina HTTP y JSON para establecer reglas claras: cómo crear, leer, modificar o borrar contenido.
La gran ventaja de REST es que es idempotente. Esto significa que si envías el mismo mensaje varias veces, el resultado es el mismo. No hay sorpresas ni comportamientos diferentes.
¿Cuáles son los métodos HTTP en una API REST?
Cada acción sobre un recurso usa un método HTTP distinto. Tomando el ejemplo de un recurso usuarios:
- GET sobre
/usuarios obtiene la lista completa de usuarios.
- GET sobre
/usuarios/{id} obtiene un usuario específico usando su identificador único.
- POST sobre
/usuarios crea un nuevo usuario con la información que envías.
- DELETE sobre
/usuarios/{id} borra el usuario indicado.
- PUT modifica el recurso completo.
- PATCH modifica solo un campo específico del recurso.
La diferencia entre PUT y PATCH es importante: si quieres reemplazar todo el usuario usas PUT, pero si solo cambias el email usas PATCH para enviar únicamente ese campo.
¿Cuál es la diferencia entre PUT y PATCH? PUT reemplaza el recurso completo con los datos nuevos. PATCH modifica solo los campos que envías, dejando el resto intacto.
¿Qué pasa si intento borrar algo que no existe?
Como la API REST mantiene un estado consistente, puedes hacer GET o DELETE sobre cualquier identificador aunque no exista. La API te responde con un mensaje JSON confirmando si la operación se ejecutó o no. Esto te permite manejar errores de forma predecible en tu código.
La base de cualquier API REST son sus mensajes, y el formato dominante en desarrollo web sigue siendo JSON. Practícalo: arma una lista de usuarios en JSON válido, pásala por un validador y compártela en los comentarios para que la revisemos juntos.
