The Galway Bus OpenAPI is a RESTful API providing travel information on Bus Eireann services in Ireland, with a focus on Galway City. The project was built with the desire to make it easier to access information about bus services in the city.
API follows a Design-First approach, firstly building how the route will look, how its return info will look, the format of parameters, etc until the entire design of the API is fleshed out. This approach lowers the barrier to entry for API development and means Business Analysts, QA's and Project Managers can have both more involvement in the development and more insight into what the end result will look like.
This project was started last year intending to give an OpenAPI for the Bus service with support for some of the newer technology such as Docker. Since then, the original developer @appsandwich has updated his repo with new features including the new API endpoints.
With this in mind, you should check out his repo for a nice working project with more features.
In order to build and run the project locally you will need the following installed :
Development can be performed locally as follows:
yarn
yarn run dev
This project follows the all-contributors specification. Contributions of any kind are welcome!
A list of contributors to this project (emoji key):
Ryan Gordon 📝 🐛 💻 🎨 📖 👀 |
Vinny Coyne 🎨 💡 🤔 |
---|
The idea for this project came from another repo I found on Github. galwaybus, by @appsandwich is a project with aims of providing a simple API to access Galway bus info, returning it in a valid JSON format.
This project was born from that project and borrows ideas and practices from it. The aim of this project was to develop a Typescript implementation of the Galway Bus API, adopting the OpenAPI specification and using modern practices like async/await.
If you are interested in seeing a Javascript implementation, take a look at galwaybus, by @appsandwich