No description
Find a file
2022-04-03 14:30:57 +02:00
.github/workflows add linter 💚 2022-04-03 14:22:39 +02:00
docs /journeys: expose loyaltyCard and firstClass, rebuild API docs 📝 2022-04-03 14:22:18 +02:00
lib fix loyalty card tests & "test" command 💚 2022-04-03 14:30:57 +02:00
routes enable OpenAPI spec, link to it 📝 2021-02-04 19:24:13 +01:00
test /journeys: expose loyaltyCard and firstClass, rebuild API docs 📝 2022-04-03 14:22:18 +02:00
.dockerignore minor changes 2019-03-27 12:22:48 +01:00
.editorconfig init from vbb-rest 2017-10-24 23:28:12 +02:00
.eslintrc.json add linter 💚 2022-04-03 14:22:39 +02:00
.gitignore render & serve API docs 2020-10-02 18:33:38 +02:00
api-docs.js readme: update badges, docs: improve url-encode note 📝 2021-02-04 19:25:04 +01:00
api.js add linter 💚 2022-04-03 14:22:39 +02:00
architecture.svg prepare for v5 2020-04-30 15:11:20 +02:00
Dockerfile Dockerfile: fix image metadata 🐛 2021-10-19 11:20:19 +02:00
index.js generate API docs 📝 2020-05-01 20:13:45 +02:00
license.md update license 2022-01-27 17:59:28 +01:00
package.json fix loyalty card tests & "test" command 💚 2022-04-03 14:30:57 +02:00
readme.md Update readme.md 2021-11-27 14:49:49 +01:00

db-rest

A clean REST API wrapping around the Deutsche Bahn HAFAS API. It is deployed at v5.db.transport.rest.

API Documentation

db-rest architecture diagram

API status dependency status ISC-licensed support me via GitHub Sponsors chat with me on Twitter

installing & running

db-rest expects a Redis server running on 127.0.0.1:6379 (default port), but you can set the REDIS_URL environment variable to change this.

via Docker

A Docker image is available as derhuerst/db-rest:5.

docker run -d -p 3000:3000 derhuerst/db-rest:5

Note: The Docker image does not contain the Redis server.

manually

git clone https://github.com/derhuerst/db-rest.git
cd db-rest
git checkout 5
npm install --production

redis-server &
npm start

To keep the API running permanently, use tools like forever or systemd.

  • vbb-rest  A clean REST API wrapping around the VBB API.
  • bvg-rest  A clean REST API wrapping around the BVG API.
  • hvv-rest  A clean REST API wrapping around the HVV API.
  • hafas-rest-api  Expose a HAFAS client via an HTTP REST API.
  • hafas-client  JavaScript client for HAFAS public transport APIs.

Contributing

If you have a question, found a bug or want to propose a feature, have a look at the issues page.