Railnova biedt een Algemene HTTP REST API op gegevens aan alle Enterprise klanten die 24 uur per dag beschikbaar is onder de volgende voorwaarden.

Authenticatie gebeurt via Basic Authentication (over HTTPS) met een Railnova gebruikersnaam en wachtwoord. We adviseren je een specifieke gebruiker voor elke interface aan te maken die je met de API van Railnova wilt implementeren.

Als je niet over de rechten beschikt om een nieuwe gebruiker op het Railnova platform aan te maken, neem dan contact op met de beheerder van je bedrijf.

Omgeving: Productie

Host: [jouw-bedrijf].railnova.eu

Ingangspunt: api/

Protocol: HTTPS

URL voorbeeld: https://[jouwbedrijf].railnova.eu/api/

> Belangrijk: je moet [jouw-bedrijf] vervangen door je bedrijfssleutel. Deze sleutel kun je vinden wanneer je het Railnova platform in de URL opent.

Omgeving: Test

Host: test.railnova.eu

Ingangspunt: api/

Protocol: HTTPS

URL-voorbeeld: https://test.railnova.eu/api/

Het grootste deel van onze API REST-interface is gepagineerd om de beste prestaties te garanderen.

Gepagineerde endpoints sturen standaard 50 elementen terug. Je kunt extra pagina's met de pagina parameter in je HTTPS GET verzoek specificeren.

Voorbeeld: https://one.railnova.eu/api/counters/?page=2

Opmerking: Je hoeft de pagina-parameter niet op te geven om de eerste pagina van het resultaat te krijgen. Als de pagina-queryparameter niet wordt opgegeven, zal het systeem de waarde standaard op 1 zetten.

De header van de antwoorden op je verzoeken bevat paginagegevens (https://tools.ietf.org/html/rfc8288) en zou er ongeveer zo uit moeten zien* :

*Het voorbeeld bevat regels voor de leesbaarheid.

De mogelijke waarden zijn:

Er zijn meerdere informatiebronnen op het internet over het analyseren van Link Header paginering in verschillende programmeertalen; hier zijn er een paar:

De volgende eindpunten vallen onder de Railnova - Algemene HTTP REST API voorwaarden:

Je kunt de optie "Pretty print" bovenaan de pagina selecteren om de API resultaten met regeleinden weer te geven zodat ze makkelijker te lezen zijn.

Zonder "pretty print":

Met "pretty print":

De Railnova - Algemeen HTTP REST API is gelimiteerd om misbruik te voorkomen. De beperkingen zijn als volgt:

Deze limiet geldt per gebruiker en voor alle endpoints.

Onthoud dat de limiet na 7,2 minuten is bereikt als je de burstsnelheid gebruikt.

Hou er rekening mee dat als je telematicagegevens opvraagt, telt elke minuut aan gegevens als één aanvraag. De limieten voor de telematica-eindpunten (flat_event en telematics/events) kunnen dus snel bereikt worden als je een grote hoeveelheid data opvraagt.
Als je een grote hoeveelheid telematicagegevens in een keer nodig hebt, adviseren we je om onze functie “Gegevens exporteren” te gebruiken zoals uitgelegd in dit artikel.

Bij het bereiken van deze limiet krijgen alle volgende verzoeken een 429 HTTP foutmelding met informatie over wanneer het volgende succesvolle verzoek zal worden geaccepteerd.

Als deze limiet te laag is voor je gebruik, aarzel dan niet om ons Sales team te contacteren.

Onder deze Railnova - Algemeen HTTP REST API voorwaarden, willen we ervoor zorgen dat onze klanten geïnformeerd worden en de tijd hebben om hun systemen te updaten voor ingrijpende veranderingen plaatsvinden, terwijl de normale functie- en productontwikkeling workflows bij Railnova mogelijk blijven.

Een functierelease kan bepaalde functies uit eerdere releases vervangen ("een ingrijpende wijziging"). Wanneer we ingrijpende wijzigingen uitbrengen, informeren we je vóór de releasedatum over de ingrijpende wijzigingen en garanderen we dat de wijzigingen zes maanden lang terug compatibel zijn (als je binnen twee weken reageert).

Dit soort wijzigingen worden beschouwd als "breaking" in de Railnova API:

Wij bieden geen garanties met betrekking tot de Railnova Algemene API op:

Om over ingrijpende wijzigingen geïnformeerd te worden, moet je je gebruik van de api hier registreren: https://forms.gle/tNRDb82996PkKRk79

Heb je nog vragen? Ga naar het Railnova-platform en klik op "Contact" voor hulp.
​