{"id":20562613,"url":"https://github.com/sixtusagbo/alx-files_manager","last_synced_at":"2026-02-10T01:02:24.273Z","repository":{"id":272354423,"uuid":"913972046","full_name":"sixtusagbo/alx-files_manager","owner":"sixtusagbo","description":"A file manager API built with Express","archived":false,"fork":false,"pushed_at":"2025-01-13T21:20:43.000Z","size":20667,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-13T22:29:56.221Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/sixtusagbo.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":"2025-01-08T17:46:06.000Z","updated_at":"2025-01-13T21:20:46.000Z","dependencies_parsed_at":"2025-01-13T22:30:39.816Z","dependency_job_id":"d00ab1b1-0acf-47de-9144-c3484ab3e1fd","html_url":"https://github.com/sixtusagbo/alx-files_manager","commit_stats":null,"previous_names":["sixtusagbo/alx-files_manager"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sixtusagbo%2Falx-files_manager","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sixtusagbo%2Falx-files_manager/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sixtusagbo%2Falx-files_manager/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sixtusagbo%2Falx-files_manager/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sixtusagbo","download_url":"https://codeload.github.com/sixtusagbo/alx-files_manager/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242171483,"owners_count":20083558,"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":["back-end","es6","expressjs","javascript","kue","mongodb","nodejs","nosql","redis"],"created_at":"2024-11-16T04:12:01.801Z","updated_at":"2026-02-10T01:02:22.040Z","avatar_url":"https://github.com/sixtusagbo.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# File Manager API\n\nA robust file management API built with Express.js, MongoDB, and Redis. This application allows users to upload, manage and share files with authentication and caching capabilities.\n\n## Technologies\n\n- **Express.js**: Backend framework\n- **MongoDB**: Main database for storing user and file information\n- **Redis**: Caching and session management\n- **Node.js**: Runtime environment\n\n## Key Features\n\n- User authentication and session management\n- File upload and storage management\n- File access control (public/private)\n- Folder structure support\n- Image thumbnail generation\n- Pagination for file listing\n\n## API Endpoints\n\n### Authentication\n\n- `GET /connect` - User login (Basic Auth)\n- `GET /disconnect` - User logout\n- `POST /users` - Create new user\n\n### Files\n\n- `POST /files` - Upload a new file\n- `GET /files/:id` - Get file by ID\n- `GET /files` - List all files (with pagination)\n- `PUT /files/:id/publish` - Make file public\n- `PUT /files/:id/unpublish` - Make file private\n- `GET /files/:id/data` - Get file content\n\n### System\n\n- `GET /status` - Check API status\n- `GET /stats` - Get stats about users and files\n\n## Installation\n\n```bash\n# Install dependencies\nnpm install\n\n# Configure environment variables\ncp .env.example .env\n# Edit .env with your MongoDB and Redis configurations\n\n# Start the server\nnpm start\n```\n\n## Environment Variables\n\n```\nDB_HOST=localhost\nDB_PORT=27017\nDB_DATABASE=files_manager\nFOLDER_PATH=/tmp/files_manager\n```\n\n## Contributing\n\n1. Fork the repository\n2. Create a feature branch\n3. Commit changes\n4. Push to the branch\n5. Open a Pull Request\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsixtusagbo%2Falx-files_manager","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsixtusagbo%2Falx-files_manager","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsixtusagbo%2Falx-files_manager/lists"}