{"id":38759433,"url":"https://github.com/raykipkorir/online-bus-booking-api","last_synced_at":"2026-01-17T11:56:11.143Z","repository":{"id":168186272,"uuid":"635032416","full_name":"raykipkorir/online-bus-booking-api","owner":"raykipkorir","description":"Online bus booking REST API","archived":false,"fork":false,"pushed_at":"2024-04-24T18:54:37.000Z","size":154,"stargazers_count":4,"open_issues_count":7,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-04-24T20:23:12.250Z","etag":null,"topics":["django","django-rest-framework","python","rest-api"],"latest_commit_sha":null,"homepage":"https://online-bus-booking-api.onrender.com/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/raykipkorir.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2023-05-01T20:16:27.000Z","updated_at":"2023-05-26T10:12:02.000Z","dependencies_parsed_at":"2024-04-24T19:59:23.580Z","dependency_job_id":"3b0ec6c7-aa85-4643-9e5e-d51bf47149e9","html_url":"https://github.com/raykipkorir/online-bus-booking-api","commit_stats":null,"previous_names":["raykipkorir/online-bus-booking-api"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/raykipkorir/online-bus-booking-api","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raykipkorir%2Fonline-bus-booking-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raykipkorir%2Fonline-bus-booking-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raykipkorir%2Fonline-bus-booking-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raykipkorir%2Fonline-bus-booking-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/raykipkorir","download_url":"https://codeload.github.com/raykipkorir/online-bus-booking-api/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raykipkorir%2Fonline-bus-booking-api/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28508464,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-17T11:50:55.898Z","status":"ssl_error","status_checked_at":"2026-01-17T11:50:55.569Z","response_time":85,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: 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":["django","django-rest-framework","python","rest-api"],"created_at":"2026-01-17T11:56:11.035Z","updated_at":"2026-01-17T11:56:11.128Z","avatar_url":"https://github.com/raykipkorir.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Online Bus Booking system API\n\n![Python](https://img.shields.io/badge/Python-14354C?style=for-the-badge\u0026logo=python\u0026logoColor=white)\n![Django](https://img.shields.io/badge/Django-092E20?style=for-the-badge\u0026logo=django\u0026logoColor=white)\n![postgresql](https://img.shields.io/badge/PostgreSQL-316192?style=for-the-badge\u0026logo=postgresql\u0026logoColor=white)\n\nBuilt with Django Rest Framework.\n\n# Overview\nDeployed successfully on Render -\u003e [online-bus-booking-api](https://online-bus-booking-api.onrender.com/)\n\n[Swagger documentation](https://online-bus-booking-api.onrender.com/api/v1/schema/swagger/)\n\n[Redoc documentation](https://online-bus-booking-api.onrender.com/api/v1/schema/redoc/)\n\n# Installation\n\nClone the repository in your terminal\n```\ngit clone https://github.com/raykipkorir/online-bus-booking-api.git\n```\nNavigate into the repo\n```\ncd online-bus-booking-api\n```\nCreate virtual environment\n```\nvirtualenv venv\n```\nActivate virtual environment\n\n- For windows users\n```\nvenv\\Scripts\\activate\n```\n- For unix based systems\n```\nsource venv/bin/activate\n```\nInstall dependencies\n```\npip install -r requirements.txt\n```\nRun migrations and server\n```\nmake server\n```\nNote: Create .env file in the root directory to store your environment variables. Check .env.example to see environment variables that should be created.\n\n# Endpoints\n\n## Authentication\n\n```\n/api/token/  - to login users\n```\n\n```\n/api/token/refresh/\n```\n\n## Users\n\n```\n/api/users/ - create and retrieve all users(admin only)\n```\n\n```\n/api/users/\u003cid\u003e/ - retrieve, update, delete specific user by id (admin only)\n```\n\n```\n/api/users/me/ - retrieve, update, delete logged in user\n```\n\n```\n/api/users/set_password/ - change password\n```\n\n```\n/api/users/reset_password/ - reset password\n```\n\n\n## TripBus - Bus scheduled for a certain trip\n```\n/api/buses/\u003cid\u003e/trip-bus/ (admin only)- All trips for a certain bus\n```\n```\n/api/buses/\u003cid\u003e/trip-bus/\u003cid\u003e/ (admin only) - Retrieve, update or delete a trip for a certain bus\n```\n```\n/api/trip-bus/?from=\u0026to=\u0026travel_date= - Query trips using start, destination and date of travel\n```\n## Ticket\n```\n/api/buses/\u003cid\u003e/trip-bus/\u003cid\u003e/tickets/ - Create ticket for a certain trip(all users) or list all tickets for a certain trip(admin only)\n```\n```\n/api/buses/\u003cid\u003e/trip-bus/\u003cid\u003e/tickets/\u003cid\u003e - Retrieve ticket(all users) or update, delete ticket for a certain trip(admin only)\n```\n# Admin dashboard routes\n## Bus\n```\n/api/buses/ - list and create bus (admin only)\n```\n```\n/api/buses\u003cid\u003e - retrieve, update and delete bus (admin only)\n```\n## Drivers\n```\n/api/drivers/ - list and create driver (admin only)\n```\n```\n/api/drivers/\u003cid\u003e - retrieve, update and delete driver (admin only)\n```\n## Routes\n```\n/api/routes/ - list and create route (admin only)\n```\n```\n/api/routes/\u003cid\u003e - retrieve, update and delete route (admin only)\n```\n## Admins\n```\n/api/admins/ - list and create new admins (admin only)\n```\n```\n/api/admins/\u003cid\u003e - retrieve, update and delete admin (admin only)\n```\n## Contribute\nAny minor contribution would be greatly appreciated\n\nHappy coding 💚\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fraykipkorir%2Fonline-bus-booking-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fraykipkorir%2Fonline-bus-booking-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fraykipkorir%2Fonline-bus-booking-api/lists"}