{"id":19737067,"url":"https://github.com/licetlemus/dev015-fleet-management-api","last_synced_at":"2026-05-06T15:45:26.163Z","repository":{"id":254141954,"uuid":"845606350","full_name":"LicetLemus/DEV015-fleet-management-api","owner":"LicetLemus","description":"Este proyecto consiste en desarrollar una API REST para gestionar y consultar las ubicaciones de casi 10 mil taxis en Beijing, China. El objetivo es explorar soluciones eficientes para almacenar y procesar volúmenes de datos, asegurando una experiencia de usuario óptima.","archived":false,"fork":false,"pushed_at":"2024-09-25T16:26:34.000Z","size":338,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-28T05:41:27.777Z","etag":null,"topics":["api","api-rest","flask","jwt-authentication","jwt-token","pip","posgtresql","python","sql","sqlalchemy"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/LicetLemus.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-08-21T15:12:15.000Z","updated_at":"2024-10-29T20:33:46.000Z","dependencies_parsed_at":"2025-01-10T19:20:56.782Z","dependency_job_id":"97142451-b2f8-4e19-9cca-19a037ca2f1c","html_url":"https://github.com/LicetLemus/DEV015-fleet-management-api","commit_stats":null,"previous_names":["licetlemus/dev015-fleet-management-api"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/LicetLemus/DEV015-fleet-management-api","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LicetLemus%2FDEV015-fleet-management-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LicetLemus%2FDEV015-fleet-management-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LicetLemus%2FDEV015-fleet-management-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LicetLemus%2FDEV015-fleet-management-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/LicetLemus","download_url":"https://codeload.github.com/LicetLemus/DEV015-fleet-management-api/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LicetLemus%2FDEV015-fleet-management-api/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262937972,"owners_count":23387706,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","api-rest","flask","jwt-authentication","jwt-token","pip","posgtresql","python","sql","sqlalchemy"],"created_at":"2024-11-12T01:09:22.066Z","updated_at":"2025-10-31T07:51:00.995Z","avatar_url":"https://github.com/LicetLemus.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Fleet Management API\n\n## Índice\n\n* [1. Introducción](#1-introducción)\n* [2. Tecnologías](#2-tecnologías)\n* [3. Uso](#3-uso)\n* [4. Autorización](#4-autorización)\n* [5. Manejo de errores](#5-manejo-de-errores)\n\n***\n\n## 1. Introducción\n\nEsta API REST permite gestionar los datos de una flota de taxis, proporcionando funcionalidades como la carga masiva de datos históricos de GPS, consulta de ubicaciones en tiempo real y administración de usuarios. También ofrece autenticación segura mediante JWT para proteger todos los endpoints.\n\n## 2. Tecnologías\n\n- **Python**: Lenguaje de programación utilizado.\n- **Flask**: Framework para el desarrollo de la API.\n- **SQLAlchemy**: ORM para gestionar la base de datos.\n- **Flask-JWT-Extended**: Manejo de autenticación y autorización con tokens JWT.\n- **PostgreSQL**: Base de datos utilizada para almacenar los datos de los taxis y usuarios.\n\n## 3. Uso\n\nA continuación se describen los principales endpoints disponibles:\n\n- **GET /taxis**: Obtiene el listado de taxis. Soporta los parámetros `plate`, `page` y `limit`. Ejemplo: `/taxis?limit=3\u0026page=2`\n- **GET /trajectories**: Obtiene el listado de trayectorias, teniendo en cuenta el parámetro `taxiId` y `date`. Ejemplo: `/trajectories?taxiId=6418\u0026date=02-02-2008`\n- **GET /trajectories/latest**: Obtiene la última trayectoria de cada taxi. Ejemplo: `trajectories/latest`\n- **POST /users**: Crea nuevos usuarios\n`{\n  \"name\": \"user2\",\n  \"email\": \"admin2@test.com\",\n  \"password\": \"test2\"\n} `\n- **GET /users**: Obtiene el listado de usuarios. Soporta los parámetros `page` y `limit`\n- **PATCH /users/\u003cid\u003e**: Actualiza la información de un usuario basado en el ID\n`{\n  \"name\": \"Grace Hopper update\"\n}`\n- **DELETE /users/\u003cid\u003e**: Elimina un usuario\n\n## 4. Autorización\n\nPara acceder a los endpoints protegidos, se requiere un token JWT. El token debe incluirse en el encabezado de las solicitudes con el formato `Authorization: Bearer \u003ctoken\u003e`\n\n## 5. Manejo de errores\n\n- **401 Unauthorized**: El token JWT es inválido o no está presente en el encabezado de la solicitud.\n- **404 Not Found**: El recurso solicitado no se encuentra. Se debe verificar que el endpoint y los parámetros sean correctos.\n- **400 Bad Request**:  La solicitud tiene errores. Es necesario verificar que todos los parámetros y datos sean correctos.\n- **500 Internal Server Error**: Error en el servidor.\n\nGracias por visitar este proyecto. Se espera que la API sea útil y que quienes trabajen con ella disfruten del proceso\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flicetlemus%2Fdev015-fleet-management-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flicetlemus%2Fdev015-fleet-management-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flicetlemus%2Fdev015-fleet-management-api/lists"}