Starter's Guide

Welkom bij het API-Portaal van CZ!

CZ biedt een verzameling van API's aan waarmee je onze services kunt integreren in jouw applicaties. Deze pagina zal je voorzien van informatie om de API’s aan te kunnen roepen.

In de starters guide wordt stap voor stap uitgelegd hoe je de CZ API's kunt gebruiken.

Registratie

Voordat je gebruik kan maken van de API’s heb je een account nodig. Je logt in met je CZ account via aanmelden.

  • Vul je gegevens in

  • Verstuur het formulier

Je ontvangt een automatische e-mail waarin staat dat de registratie is voltooid. Let op: het kan een aantal minuten duren voordat je de beschikbare API’s kunt zien in het portaal.

API's

In deze lijst zie je een overzicht beschikbare API’s. Daarnaast is een korte omschrijving van de API weergegeven. Met behulp van de zoekbalk kan je zoeken naar de voor jou relevante API. Iedere API is voorzien van uitgebreide documentatie (parameters, voorbeeld request).

Wil je gebruik maken van de API? Vraag dan toegang aan via het product.

Producten

Een product kan bestaan uit één of meedere API’s. Welke producten er allemaal zijn vind je hier.
Om gebruik te kunnen maken van een API heb je een key nodig.

  • Ga naar de productenpagina

  • Klik op het gewenste product

  • Klik op Abonneren

  • Ga akkoord met de eventuele gebruikersvoorwaarden en klik op bevestigen


Je wordt geleid naar je persoonlijke profiel pagina waar je de status van de aanvraag kan vinden. Daarnaast krijg je een automatisch gegenereerde e-mail met een bevestiging van je inschrijvingsverzoek op dit product. Indien goedkeuring van het abonnement vereist is zal de eigenaar van de API je verzoek zo snel mogelijk keuren, hiervan krijg je zo snel mogelijk bericht

Gebruik van de API

Zodra je bericht hebt gehad dat je succesvol een abonnement hebt afgesloten, kan je aan de slag met de API

  • Klik op je naam rechts bovenin het scherm

  • Kies voor profiel om een overzicht te zien van jou abonnementen

  • Ieder product heeft een unieke key (primary of secondary), neem deze key over in de request header om een succesvolle API
    request uit te voeren

Het gebruik van de API’s is gratis. Er is wel een limiet aan het aantal calls dat uitgevoerd mag worden. Dit verschilt per product. CZ heeft altijd de mogelijkheid om het limiet aan te passen als dit gewenst is.