Esta es una implementación API que cuenta con seis endpoints principales:
- Consulta de la cantidad de viajes totales.
- Consulta de la cantidad de viajes totales por ciudad.
- Consultar la cantidad de viajes totales por país.
- Crear un viaje.
- Actualizar un viaje.
- Consultar los viajes actuales
Esta api fue realizada con el framework Django de Python y se encuentra dentro de la carpeta backend_test. Su despliegue se puede encontrar en el siguiente enlace https://miaguilabackendtest.herokuapp.com/api/v1/.
Si desea realizar el despliegue local del test es necesario tener instalado python3 y mongodb en el sistema. En el caso de Ubuntu(linux) basta con ejecutar los siguientes comandos para su instalación:
sudo apt-get install python3.6
sudo apt install -y mongodb
Para la implementación se utilizó el gestor de paquetes de python PIP3 para instalar los paquetes necesarios en el proyecto.
sudo apt install python3-pip
Para la ejecución de la aplicación basta con realizar la instalación de los paquetes utilizados en el proyecto con el siguiente comando
pip install -r requirements.txt
Posteriormente se debe ejecutar el servidor utilizando el siguiente comando
python3 manage.py runserver
El servidor de desarrollo será lazado en http://127.0.0.1:8000/
Aunque el servidor fue lanzado en http://127.0.0.1:8000/
. La dirección inicial del api se encuentra en http://127.0.0.1:8000/api/v1/
Como se enuncia al inicio el api cuenta con seis endpoints los cuales encuentran en las siguientes direcciones:
- Consulta de la cantidad de viajes totales:
http://127.0.0.1:8001/api/v1/trips/count
- Consulta de la cantidad de viajes totales por ciudad:
http://127.0.0.1:8001/api/v1/trips/count/?city=name_city
- Consultar la cantidad de viajes totales por país:
http://127.0.0.1:8001/api/v1/trips/count/?country=name_country
- Crear un viaje.
http://127.0.0.1:8000/api/v1/trips/
- Actualizar un viaje.
http://127.0.0.1:8000/api/v1/trips/id_trip/
- Consultar los viajes actuales
http://127.0.0.1:8001/api/v1/trips/?status=started
Los métodos HTTP usados para cada petición son:
- Consulta de la cantidad de viajes totales. [GET]
- Consulta de la cantidad de viajes totales por ciudad. [GET]
- Consultar la cantidad de viajes totales por país. [GET]
- Crear un viaje. [POST]
- Actualizar un viaje. [PUT]
- Consultar los viajes actuales. [GET]
La documentación completa se puede encontrar en el archivo swagger.yaml. Para ver la documentación basta con importar el archivo en http://editor.swagger.io/.
El flujo de trabajo implementado fue Git flow. Cada característica del desarrollo se realizo en una rama individual, la cual tenia como padre la rama develop. Al final todas las ramas fueron unidas con su rama padre utilizando rebase.
Los retos se pueden encontrar en la carpeta challenges