generate-db-shop-urls

Magically generate Deutsche Bahn ticket URLs.

Usage no npm install needed!

<script type="module">
  import generateDbShopUrls from 'https://cdn.skypack.dev/generate-db-shop-urls';
</script>

README

generate-db-shop-urls

Magically generate Deutsche Bahn ticket URLs. Given a journey queried with hafas-client@5, it tries to generate a matching ticket link in the Deutsche Bahn shop. Caveats:

  • Uses a lot of scraping, as there is no (publicly accessible) machine-readable interface to the ticket system. This makes generate-db-shop-urls brittle.
  • Because of how (bad) the shop works, the generated links will only be valid with a browser session that hasn't recently been used to search for a connection, or one without any cookies/session.

npm version build status Prosperity/Apache license chat on gitter support me via GitHub Sponsors

Installing

npm install generate-db-shop-urls

Usage

generate-db-shop-urls expects one (outbound) or two (outbound & returning) journeys queried with hafas-client@5 as input.

const createHafas = require('db-hafas')
const generateTicketLink = require('generate-db-shop-urls')

const berlin = '8096003'
const hamburg = '8000157'
const hafas = createHafas('my-awesome-program')

const outbound = await hafas.journeys(berlin, hamburg, {
    departure: new Date('2017-05-18T05:00+0200'),
    results: 1,
})
const returning = await hafas.journeys(hamburg, berlin, {
    departure: new Date('2017-05-19T12:00+0200'),
    results: 1,
})

const link = await generateTicketLink(outbound.journeys[0], {
    returning:  returning.journeys[0],
})
console.log(link)

API

async (outbound, opt = {}) => {}

opt overrides the default options which look as follows:

{
    // type of BahnCard, '0' = no bahncard
    // see https://gist.github.com/juliuste/202bb04f450a79f8fa12a2ec3abcd72d
    bahncard: '0',
    class: '2', // '1' or '2'
    age: 40, // age of the traveller
    returning: null // returning journey to match (optional)
}

License

This project is dual-licensed: My contributions are licensed under the Prosperity Public License, contributions of other people are licensed as Apache 2.0.

This license allows you to use and share this software for noncommercial purposes for free and to try this software for commercial purposes for thirty days.

Personal use for research, experiment, and testing for the benefit of public knowledge, personal study, private entertainment, hobby projects, amateur pursuits, or religious observance, without any anticipated commercial application, doesn’t count as use for a commercial purpose.

Buy a commercial license or read more about why I sell private licenses for my projects.

Contributing

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

By contributing, you agree to release your modifications under the Apache 2.0 license.