Skip to main content
Operators publish new tariffs once a year and correct them at any time. Rather than re-reading every operator to find out, subscribe: the service sends a signed POST to your address when an operator’s tariffs change. Subscriptions need an API key.

Subscribing

Leave out vse_numbers to hear about every operator. The answer carries the secret that signs your deliveries. It is shown this once; keep it.
At most ten subscriptions per key. Only public https:// addresses are accepted; a name that resolves to a private or loopback address is refused, and checked again at every delivery.

What arrives

Changes are detected once a night, after the collection run. Each changed operator and tariff year is one delivery:
The delivery says that something changed, not what: fetch url for the tariffs as they are now. previous is null the first time an operator publishes a year.

Verifying the signature

Compute HMAC-SHA256 of the raw body with your secret and compare in constant time.

Answering

Answer with any 2xx within ten seconds. Anything else, a timeout, or a redirect (redirects are not followed) counts as failed; the delivery is tried again on the next nightly run, up to five times in all.