{"id":21894303,"url":"https://github.com/emmaisaac/server-express-pers-json","last_synced_at":"2026-02-01T11:34:52.719Z","repository":{"id":263656825,"uuid":"867246346","full_name":"EmmaIsaac/server-express-pers-json","owner":"EmmaIsaac","description":"Este proyecto es una API simple construida con Express para administrar un catalogo de Autos.","archived":false,"fork":false,"pushed_at":"2024-11-19T17:50:36.000Z","size":731,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-17T10:11:27.166Z","etag":null,"topics":["api","crud-api","express","git","javascript","json","nodejs"],"latest_commit_sha":null,"homepage":"","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/EmmaIsaac.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-10-03T17:48:54.000Z","updated_at":"2024-11-19T17:50:39.000Z","dependencies_parsed_at":null,"dependency_job_id":"2c6609ea-702b-481f-8a87-ddf6895b4d8c","html_url":"https://github.com/EmmaIsaac/server-express-pers-json","commit_stats":null,"previous_names":["emmaisaac/server-express-pers-json"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/EmmaIsaac/server-express-pers-json","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EmmaIsaac%2Fserver-express-pers-json","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EmmaIsaac%2Fserver-express-pers-json/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EmmaIsaac%2Fserver-express-pers-json/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EmmaIsaac%2Fserver-express-pers-json/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/EmmaIsaac","download_url":"https://codeload.github.com/EmmaIsaac/server-express-pers-json/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EmmaIsaac%2Fserver-express-pers-json/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28977318,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-01T11:31:13.034Z","status":"ssl_error","status_checked_at":"2026-02-01T11:30:25.558Z","response_time":56,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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","crud-api","express","git","javascript","json","nodejs"],"created_at":"2024-11-28T13:21:41.379Z","updated_at":"2026-02-01T11:34:52.693Z","avatar_url":"https://github.com/EmmaIsaac.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# API de Express con Persistencia en Archivo JSON\n\nEste proyecto es una API simple construida con Express para administrar un catalogo de Autos. La información se persiste en un archivo JSON que funciona como base de datos. La API permite realizar operaciones CRUD: obtener todo el catalogo, obtener un elemento por ID, agregar nuevos elementos, actualizar un elemento y eliminar elementos.\n\n## Instalación\n\n### Requisitos previos\n\n- Node.js (versión 14 o superior)\n- npm (viene con Node.js)\n\n### Clonar el repositorio\n\n```bash\ngit clone https://github.com/EmmaIsaac/server-express-pers-json.git\ncd server-express-pers-json\n```\n\n### Instalar las dependencias\n\nUna vez dentro de la carpeta del proyecto, ejecuta el siguiente comando para instalar las dependencias:\n\n```bash\nnpm install\n```\n\n## Uso\n\n### Iniciar la aplicación\n\nPara iniciar el servidor, utiliza el siguiente comando:\n\n```bash\nnpm run dev\n```\n\nPor defecto, el servidor se ejecutará en `http://localhost:3000`.\n\n### Endpoints de la API\n\n| Método | Ruta           | Descripción                                   |\n| ------ | -------------- | --------------------------------------------- |\n| GET    | `api/cars`     | Obtiene todos los elementos.                  |\n| GET    | `api/cars/:id` | Obtiene un elemento específico por su ID.     |\n| POST   | `api/cars`     | Crea un nuevo elemento.                       |\n| PATCH  | `api/cars/:id` | Actualiza parcialmente un elemento por su ID. |\n| DELETE | `api/cars/:id` | Elimina un elemento por su ID.                |\n\n### Ejemplos de uso\n\n#### Obtener todos los elementos\n\n**Solicitud:**\n\n```bash\nGET api/cars\n```\n\n**Respuesta:**\n\n```json\n[\n  {\n    \"id\": \"f1d5a7f2-e6bc-4e90-8a1e-70a7c57cfcf1\",\n    \"brand\": \"Tesla\",\n    \"model\": \"Model 3\",\n    \"year\": 2022\n  },\n  {\n    \"id\": \"c2b9c3fa-7c3b-4829-92d2-4b0fa2a1e1a1\",\n    \"brand\": \"Honda\",\n    \"model\": \"Civic\",\n    \"year\": 2020\n  },\n  {\n    \"id\": \"53b1ebe8-e22b-4e39-9b10-d82b0b78f0d5\",\n    \"brand\": \"Chevrolet\",\n    \"model\": \"Virtus\",\n    \"year\": 2024\n  }\n]\n```\n\n#### Obtener un elemento por ID\n\n**Solicitud:**\n\n```bash\nGET api/cars/c2b9c3fa-7c3b-4829-92d2-4b0fa2a1e1a1\n```\n\n**Respuesta:**\n\n```json\n{\n  \"id\": \"c2b9c3fa-7c3b-4829-92d2-4b0fa2a1e1a1\",\n  \"brand\": \"Honda\",\n  \"model\": \"Civic\",\n  \"year\": 2020\n}\n```\n\n#### Crear un nuevo elemento\n\n**Solicitud:**\n\n```bash\nPOST api/cars\n\n{\n  \"brand\": \"Nueva Marca\",\n  \"model\": \"Nuevo Modelo\",\n  \"year\": 2020\n}\n```\n\n**Respuesta:**\n\n```json\n{\n  \"id\": \"c2b9c3fa-7c3b-4829-92d2-4b0fa2a1e1a1\",\n  \"brand\": \"Honda\",\n  \"model\": \"Civic\",\n  \"year\": 2020\n}\n```\n\n#### Actualizar un elemento parcialmente\n\n**Solicitud:**\n\n```bash\nPATCH api/cars/c2b9c3fa-7c3b-4829-92d2-4b0fa2a1e1a1\n\n{\n  \"brand\": \"Marca Modificada\",\n\n}\n```\n\n**Respuesta:**\n\n```json\n{\n  \"id\": \"c2b9c3fa-7c3b-4829-92d2-4b0fa2a1e1a1\",\n  \"brand\": \"Toyota - Nueva Marca\",\n  \"model\": \"Civic\",\n  \"year\": 2020\n}\n```\n\n#### Eliminar un elemento\n\n**Solicitud:**\n\n```bash\nDELETE api/cars/c2b9c3fa-7c3b-4829-92d2-4b0fa2a1e1a1\n```\n\n**Respuesta:**\n\n```json\n{\n  \"id\": \"c2b9c3fa-7c3b-4829-92d2-4b0fa2a1e1a1\",\n  \"brand\": \"Honda\",\n  \"model\": \"Civic\",\n  \"year\": 2020\n}\n```\n\n## Dependencias\n\n- **Express**: Framework de Node.js utilizado para crear la API.\n- **fs**: Módulo de Node.js utilizado para leer y escribir en el archivo JSON.\n\n## Licencia\n\nEste proyecto está bajo la licencia MIT.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Femmaisaac%2Fserver-express-pers-json","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Femmaisaac%2Fserver-express-pers-json","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Femmaisaac%2Fserver-express-pers-json/lists"}