De Infradock API gebruikt API-sleutels om verzoeken te verifiëren. U kunt uw API-sleutels opvragen bij Infradock.

Uw API-sleutels hebben veel privileges, dus zorg ervoor dat u ze veilig bewaart! Deel uw geheime API-sleutels niet in openbaar toegankelijke gebieden zoals GitHub, client-side code, enzovoort.

Alle API-verzoeken moeten via HTTPS worden gedaan. Oproepen via gewone HTTP mislukken. API-verzoeken zonder authenticatie zullen ook mislukken.

Om gebruik te maken van de Infradock API heeft u minimaal de volgende gegevens nodig:

  1. X-API-Key: <X_API_Key>
  2. Username: MD_ServiceAccount_<Netbeheerder/Aannemer/Gemeente>
  3. Password: <Wachtwoord>
  4. User-Identity: <Gebruikers e-mailadres>

Start

Om de API-sleutel te krijgen waarmee u verzoeken kunt sturen naar de integratie moet er eerst een verzoek naar de ‘/session/token’ call worden gemaakt. Deze call verwacht een X-API-Key en een Basic Authentication token in de Authorization header. 

Als deze call succesvol is krijgt u een bearer token terug die mee moet worden gestuurd met de andere verzoeken naar de API in de Authorization header. U kunt hiermee verzoeken verifiëren.