Esprit-ICT API's

Het development team heeft de volgende API's vrijgegeven voor gebruik:

  • Internal API - alléén te gebruiken voor interne applicaties/bronnen.
  • Public API - te gebruiken voor externe applicaties/bronnen.

✌️ Gebruik maken van een API

Om gebruik te kunnen maken van de API's, dient de applicatie/bron een eigen cliëntingang te hebben binnen Zetacom Identity server. Via de Identity server wordt het gebruik van de API's gereguleerd. Een cliëntingang kan worden aangevraagd bij het development team, middels een servicebon. Je ontvangt van het development team dan inloggegevens die gebonden zijn aan jouw applicatie/bron.

Bij het versturen van een API call dient een zogeheten Bearer token meegestuurd te worden in de header. Via deze token wordt jouw applicatie/bron geauthentiseerd. Een voorbeeld van een Bearer token header:

Authorization: Bearer AAAAAAAAAAAAAAAAAAAAAMLheAAAAAAA0%2BuSeid%2BULvsea4JtiGRiSDSJSI%3DEUifiRBkKG5E2XzMDjRfl76ZC9Ub0wnz4XsNiRVBChTYbJcE3F

⛔ Breaking Changes

Om binnen jouw applicatie de Zetacom API na elke major release goed te laten werken, is er een pagina met breaking changes beschikbaar gesteld. Hierin staat vermeld welke wijzigingen er in de methodes zijn aangebracht die binnen jouw applicatie handmatige aanpassingen vereisen.

📃 Changelog

Om een goed overzicht te hebben welke functionaliteiten er na een update beschikbaar zijn gekomen en welke veranderingen er in de onderliggende code is doorgevoerd, is er een changelog opgesteld. Hierin staan de veranderingen van alle afgelopen versies. Een nieuwe versie wordt spoedig na release toegevoegd.

📒 API documentatie

Om te weten welke aanvragen er gedaan kunnen worden naar de verschillende API's heeft het development team de API's gedocumenteerd via Swagger, te benaderen via API documentatie. De API's maken gebruik van de REST architectuur.

Heb je zelf een wijziging of feature die je graag terugziet in een van de API's? Meldt dit dan bij het development team middels een servicebon of mail naar service@esprit-ict.nl.