{"id":15154315,"url":"https://github.com/moisesgj/moisesgj-links","last_synced_at":"2026-01-20T04:32:08.074Z","repository":{"id":254533807,"uuid":"846368451","full_name":"MoisesGJ/moisesgj-links","owner":"MoisesGJ","description":"MoisesGJ Links es una aplicación de acortamiento de URLs construida con Node.js y MongoDB. Permite a los usuarios generar enlaces acortados y recuperarlos fácilmente. Incluye validaciones y almacenamiento de datos en MongoDB.","archived":false,"fork":false,"pushed_at":"2024-10-03T23:29:37.000Z","size":1034,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-13T14:38:15.518Z","etag":null,"topics":["api-rest","back-end","express","mongo","mongod"],"latest_commit_sha":null,"homepage":"https://moisesgj-links.vercel.app","language":"JavaScript","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/MoisesGJ.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-23T04:06:15.000Z","updated_at":"2024-08-24T06:39:03.000Z","dependencies_parsed_at":"2024-11-02T20:01:51.284Z","dependency_job_id":null,"html_url":"https://github.com/MoisesGJ/moisesgj-links","commit_stats":{"total_commits":9,"total_committers":1,"mean_commits":9.0,"dds":0.0,"last_synced_commit":"1198402a74cfdf6b7f94b9d9d1271c5ddd943c2e"},"previous_names":["moisesgj/moisesgj-links"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MoisesGJ%2Fmoisesgj-links","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MoisesGJ%2Fmoisesgj-links/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MoisesGJ%2Fmoisesgj-links/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MoisesGJ%2Fmoisesgj-links/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MoisesGJ","download_url":"https://codeload.github.com/MoisesGJ/moisesgj-links/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247648928,"owners_count":20972942,"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-rest","back-end","express","mongo","mongod"],"created_at":"2024-09-26T17:21:41.380Z","updated_at":"2026-01-20T04:32:08.064Z","avatar_url":"https://github.com/MoisesGJ.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🌐 MoisesGJ Links\n\n![MoisesGJ Links](https://img.shields.io/badge/Proyecto-MoisesGJ_Links-brightgreen) ![Node.js](https://img.shields.io/badge/Node.js-v22.6.0-blue)\n\n**MoisesGJ Links** es un servicio de acortamiento de URL que permite a los usuarios crear y gestionar enlaces acortados. Este proyecto se integra con MongoDB para el almacenamiento de datos y proporciona rutas esenciales para la gestión de enlaces.\n\n## 🚀 Características\n\n- **Crear y Usar Hipervínculos**: Genera URLs acortadas y rastrea su uso.\n- **Integración con MongoDB**: Almacena y gestiona URLs y sus equivalentes acortados.\n- **API RESTful**: Accede a las principales rutas para la creación y gestión de enlaces.\n- **Preparado para el Futuro**: Arquitectura limpia preparada para futuras características.\n\n## 🛠 Instalación\n\nPara comenzar con **MoisesGJ Links**, sigue estos pasos:\n\n1. **Clonar el Repositorio**:\n\n   ```bash\n   git clone https://github.com/MoisesGJ/moisesgj-links.git\n   cd moisesgj-links\n   ```\n\n2. **Instalar Dependencias**:\n\n   Asegúrate de tener [Node.js](https://nodejs.org/) y [npm](https://www.npmjs.com/) instalados. Luego, ejecuta:\n\n   ```bash\n   npm install\n   ```\n\n3. **Configurar Variables de Entorno:**:\n\n   Crea un archivo .env en el directorio raíz del proyecto y añade tu URI de MongoDB (puedes seguir también la estructura del archivo .env.example):\n\n   ````bash\n    PORT=\n    DB_URI=mongodb://localhost:27017\n    DB_NAME=moisesgj-links\n    BASE_URL=http://localhost:3001\n    ```\n   Asegúrate de reemplazar mongodb://localhost:27017/moisesgj-links con la URI adecuada para tu base de datos MongoDB, si es diferente.\n\n   ````\n\n4. **Iniciar la Aplicación:**:\n\n   Para iniciar la aplicación en modo de desarrollo, ejecuta:\n\n   ````bash\n    npm run dev\n    ```\n\n   Para iniciar la aplicación en modo producción, ejecuta:\n\n   ```bash\n    npm start\n    ```\n   Esto iniciará el servidor en el puerto especificado en el archivo .env. Puedes acceder a la aplicación en http://localhost:3000 o en el puerto que hayas configurado.\n\n   ````\n\n5. **Verificar el Funcionamiento:**:\n\n   Para verificar el funcionamiento, puedes usar herramientas como Postman, Insomnia o cURL para probar las rutas de la API. Haz una peticion GET a http://localhost:3000 para verificar que la aplicación está funcionando correctamente.\n\n## 📚 Rutas de la API\n\n### **POST** `api/links`\n\nCrea un nuevo enlace acortado.\n\n- **Descripción**: Permite a los usuarios crear un nuevo enlace acortado.\n- **Cuerpo de la Solicitud**:\n\n  ```json\n  {\n    \"url\": \"\"http://ejemplo.com\"\n    \"shortUrl\": \"acortado\",\n  }\n  ```\n\n- **Respuesta exitosa**:\n\n  ```json\n  {\n    \"shortLink\": \"http://ejemplo.com/acortado\"\n  }\n  ```\n\n- **Códigos de estado**:\n  - **200**: Creado\n  - **400**: Error\n\n### **GET** `/:shortUrl`\n\nHace la redirección a la URL original.\n\n- **Descripción**: Permite a los usuarios obtener la redirección de la URL original a partir de un enlace acortado.\n- **Parámetros de Ruta:**: `shortUrl` (string): El enlace acortado que se desea consultar.\n\n- **Códigos de estado**:\n  - **302**: Redireccionado\n  - **404**: No se ha encontrado el enlace proporcionado\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmoisesgj%2Fmoisesgj-links","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmoisesgj%2Fmoisesgj-links","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmoisesgj%2Fmoisesgj-links/lists"}