dsbuntis

This package allows you to crawl DSB's "Mobile API" and parse Untis's HTML.

Usage

For a basic example on how to get your substitutions, please refer to the example.

Lower-level APIs (Session)

getAllSubs only accounts for the most basic usage. For a more customizable experience, you'll want to use the Session API.

Sessions are created in two ways: Logging in or using an existing token.

To log in, you call Session.login:

final session = await Session.login('187801', 'public');

To use an existing token, you previously (6.1) used Session.fromToken. Now, the Session constructor allows for passing them:

final session = Session('13ccccbb-e6a8-466a-addc-00bba830c6cf');

Then you can get the JSON with timetable information:

final ttJson = await session.getTimetableJson();

And download and parse the plans:

final downloadingPlans = session.downloadPlans(ttJson);
final plans = await parsePlans(downloadingPlans);

Caching and best practices

A very important feature in dsbuntis from the beginning has been good caching. For documentation on how to set it up for the actual requests, please refer to the schttp documentation, as it is the HTTP backend of dsbuntis. From version 6 on, however, you can aditionally cache Sessions. AFAIK the login of DSBMobile is idempotent (as indicated by it being a GET request) and always returns the same token. If it is, which you can safely assume by now, you can cache the Session's token forever. Otherwise you can still keep the Session object around for a while.