dsbuntis 8.1.0-alpha.3 icon indicating copy to clipboard operation
dsbuntis: ^8.1.0-alpha.3 copied to clipboard

This package allows you to crawl the DSB/DSBMobile API and parse Untis's HTML.

dsbuntis #

pub points

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

Usage #

The one-stop function provided by this package is getAllSubs. You can call it like this:

final plans = await getAllSubs('187801', 'public');

Lower-level APIs #

For everything more advanced than the optional arguments of getAllSubs, you will have to reach into the lower-level APIs of the dsb and untis packages. Please consult their documentation for details.

To log in, you call Session.login:

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

To use an existing token, you pass it to the Session constructor:

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

Then you can get the timetable information:

final timetables = await session.getTimetables();

And download and parse the plans, with the dsbuntis Downloading extension:

final plans = await session.downloadAndParsePlans(timetables);

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. In recent versions, however, you can aditionally cache the Session objects from dsb. 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.

pub points


verified publisher iconampless.chrissx.de

This package allows you to crawl the DSB/DSBMobile API and parse Untis's HTML.

Repository (GitHub)
View/report issues


API reference


Icon for licenses.MPL-2.0 (LICENSE)


dsb, schttp, untis, where_not_null


Packages that depend on dsbuntis