Starten

Registratie

Om gebruik te maken van deze API is registratie vereist, hiervoor is een Admin (REST) API beschikbaar. De Admin API stelt ons in staat om wijzigingen en fixes direct met ontwikkelaars te communiceren en voorkomt misbruik. (Realtime) Monitoring, Metrics en Analytics zullen onder de Admin API beschikbaar worden gesteld.

Als ontwikkelaar ben je vrij de Admin API te gebruiken of te integreren naar eigen inzicht. Voor de volledige documentatie van deze REST API verwijzen we je door naar de Swagger implementatie en Swagger Sandbox.

Om snel te kun starten hebben wij onderaan deze pagina een vereenvoudige Live Integratie van het Registratieproces beschikbaar gesteld, deze maakt gebruik van https://www.vertrektijd.info/swagger/latest/admin.json

  • 1

    Creeer een user account

    Een user account wordt gebruikt voor de afhandeling van sessies in interactie met de Admin API.
    Admin API Endpoint: https://admin.vertrektijd.info/api/v2/user/register
  • 2

    Log in

    Na succesvole registratie dien je in te loggen, bij succes ontvang je een session-token. Iedere opvolgende request dient in de headers vergezeld te worden met deze session token en een API-Key
    Voor de session token geldt de header: "X-Vertrektijd-Admin-Session-Token".
    De header met de API-Key betreft: "X-Vertrektijd-Admin-Api-Key": "8a1b2f27652bcc20d6a02241df2a4a057ebe666b856c3aa1dd46a71c60911a84", deze API-Key is statisch.
    Admin API Endpoint: https://admin.vertrektijd.info/api/v2/user/session
  • 3

    Registreer je als developer

    Applicaties worden aangemaakt onder een Developer account, dit account wordt onder andere gebruikt voor administratieve doeleinden. Eventuele business rules kunnen zowel op Developer niveau als op de Applicatie niveau worden toegepast.
    Admin API Endpoint: https://admin.vertrektijd.info/api/v2/vti_admin/_table/developer
  • 4

    Registreer een Applicatie

    Gebruik van de Vertrektijd.Info API (de Client API) vereist een applicatie specifieke API-Key, deze wordt na registratie van een applicatie aangemaakt. Ontwikkelaars zijn vrij API-Keys naar eigen inzicht te gebruiken. Iedere Ontwikkelaar krijgt bij aanvang 6 applicatie slots tot zijn beschikking, op verzoek kan dit limiet worden verhoogd. We adviseren voor ieder platform (Web/IOS/Android) een applicatie aan te maken.
    Admin API Endpoint: https://admin.vertrektijd.info/api/v2/vti_admin/_table/application
  • 5

    Bouw!

Live Registratie

User Account

Voornaam

Achternaam

E-mail

Wachtwoord

Submit

Login

E-mail

Wachtwoord

Submit

Registreer Developer

Waarden aangeduid met een * zijn verplicht

Bij succesvolle registratie wordt er een ID teruggegeven.

Voornaam*

Achternaam*

E-mail*

Betreft een Bedrijf*

Ja, dit betreft een bedrijf

Bedrijfsnaam

KVK

VAT/BTW nr

Adres*

Postcode*

Plaats*

Land*

Telefoon

Submit

Registreer Applicatie

Waarden aangeduid met een * zijn verplicht

Bij succesvolle registratie wordt er een ID en een API-Key teruggegeven. Gebruik deze API-Key in het gebruik van 'api.vertrektijd.info' (de Client API).

Applicatie Naam*

Categorie*

Omschrijving*

Commercieel gebruik?*

Ja, deze applicatie gebruikt de API voor commerciële doeleinden

Platform*

URL

Versie*

Submit

Console

  • Admin API console output