Skip to content

Ryan-Gordon/Galway-Bus-OpenAPI

Repository files navigation

Galway-Bus-OpenAPI

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.

Update 04/01/19:

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.

Installation

Prerequisites

In order to build and run the project locally you will need the following installed :

  1. NodeJS >= 8.0.0
  2. Yarn

Quickstart

Development can be performed locally as follows:


yarn

yarn run dev

Contributors

All Contributors 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

🎨 💡 🤔

Acknowledgements

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

About

An OpenAPI for retrieving bus information in Ireland.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published