POST to your address when an operator’s tariffs change.
Subscriptions need an API key.
Subscribing
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: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 any2xx 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.