📝 Curso API REST con LARAVEL | VERSIONA tu API

Summary

En este video, se explica cómo versionar una API para una aplicación móvil que gestiona usuarios. Inicialmente, la API devuelve todos los campos de los usuarios, pero al actualizar la app, solo se requiere el nombre y el email. Para evitar problemas con usuarios de la versión antigua, se versiona la API, permitiendo que cada versión de la app haga llamadas a endpoints específicos. Se muestra cómo crear y probar las llamadas en diferentes versiones, destacando la importancia de versionar APIs para mantener la compatibilidad y escalabilidad a largo plazo.

Takeaways

• 📱 La versión de la aplicación móvil inicial muestra todos los campos de los usuarios de la base de datos.
• 🛠 Modificar una API actual para que solo muestre ciertos datos puede causar errores en versiones antiguas de la aplicación.
• 🚫 No es recomendable modificar la API original para que devuelva menos información si aún hay clientes que usan la versión antigua.
• 🔄 La solución propuesta es versionar la API, creando endpoints como '/v1/users' y '/v2/users' para versiones diferentes.
• 📤 La versión antigua de la aplicación seguirá llamando al endpoint antiguo, mientras que la nueva llamará al endpoint versionado (v2).
• 📋 En el endpoint v1 se devuelven todos los datos del usuario, mientras que en el endpoint v2 solo se devuelven el nombre y el email.
• 📝 Se mostró cómo crear usuarios en la base de datos enviando solicitudes POST con el nombre, email y un password predefinido o definido por el usuario.
• 🔧 En el código, las rutas de la API se agrupan y versionan bajo un prefijo, por ejemplo, '/v2', lo que permite mantener ambas versiones.
• 🔑 En el endpoint v2 se necesita enviar el campo 'password' al crear un usuario, a diferencia del v1 donde estaba predefinido.
• 🚀 Es esencial versionar las APIs desde el inicio para asegurar una estructura escalable y productiva en el futuro.

Q & A

¿Qué es lo que se enseña en el vídeo de hoy?

En el vídeo de hoy se enseña cómo crear y versionar una API para una aplicación móvil que maneja un listado y creación de registros en una base de datos.

¿Cuál es la importancia de versionar una API?

La importancia de versionar una API es permitir que las nuevas versiones de una aplicación móvil puedan funcionar sin problemas con la API, incluso si la API ha sido actualizada para incluir cambios o mejoras.

¿Cómo se soluciona el problema de que una nueva versión de una aplicación no requiere todos los datos que devuelve la API actual?

Se soluciona creando una nueva versión de la API (por ejemplo, v2) que solo devuelva los datos necesarios para la nueva versión de la aplicación, mientras que la versión antigua de la aplicación sigue utilizando la versión antigua de la API.

¿Qué cambios se hicieron en la nueva versión de la API para adaptarse a la nueva aplicación móvil?

En la nueva versión de la API (v2), se modificó la llamada para que solo devuelva los campos 'nombre' y 'email' en lugar de todos los campos de la base de datos.

¿Cómo se crea un nuevo registro en la base de datos según el vídeo?

Se crea un nuevo registro en la base de datos a través de una llamada POST a la API, enviando los datos necesarios como 'nombre', 'email' y, en la versión v2, también se envía una 'password'.

¿Qué lenguaje de programación se menciona en el vídeo para seguir el curso?

En el vídeo se menciona que para seguir el curso es necesario tener conocimientos de 'arabe', aunque no se especifica un lenguaje de programación específico.

¿Qué tipo de llamada se usa para crear un usuario en la API?

Se usa una llamada de tipo POST para crear un usuario en la API.

¿Cuál es la diferencia entre la llamada a la API 'v1' y 'v2' según el vídeo?

La llamada a la API 'v1' devuelve todos los campos de los usuarios, mientras que la llamada a la API 'v2' solo devuelve los campos 'nombre' y 'email'.

¿Por qué es importante tener una estructura de API bien versionada desde el primer momento?

Es importante tener una estructura de API bien versionada desde el primer momento para asegurar que la aplicación sea escalable y pueda adaptarse a futuros cambios sin interrumpir el servicio para los usuarios de versiones anteriores.

¿Cómo se indica en el vídeo que se ha creado un nuevo usuario?

Se indica que se ha creado un nuevo usuario cuando la API devuelve un mensaje de éxito o un identificador único del nuevo usuario creado.