hafas-rest-api-client

An API client for hafas-rest-api endpoints.

Usage no npm install needed!

<script type="module">
  import hafasRestApiClient from 'https://cdn.skypack.dev/hafas-rest-api-client';
</script>

README

hafas-rest-api-client

A client for hafas-rest-api endpoints, e.g. for the *.transport.rest APIs.

npm version build status ISC-licensed minimum Node.js version support me via GitHub Sponsors chat with me on Twitter

Installing

npm install hafas-rest-api-client

Usage

const createClient = require('hafas-rest-api-client')

const vbbClient = createClient('https://v5.vbb.transport.rest', {
    // Please pass in a User-Agent header to let the providers of the API endpoint understand how you're using their API.
    userAgent: 'my awesome project',
})

const res = await vbbClient.journeys('900000003201', '900000024101', {results: 1})

hafas-rest-api-client is a client hafas-rest-api@3 APIs. Check their individual API docs for all supported parameters.

The response objects have special Symbol fields for meta information:

const {HEADERS, SERVER_TIMING, CACHE} = require('hafas-rest-api-client')

console.log('response headers', res[HEADERS]) // Fetch API Headers object
console.log('server timing', res[SERVER_TIMING]) // value of the Server-Timing response header
console.log('server cache', res[CACHE]) // value of the X-Cache response header

Contributing

If you have a question or have difficulties using hafas-rest-api-client, please double-check your code and setup first. If you think you have found a bug or want to propose a feature, refer to the issues page.