Naar hoofdinhoud gaan
Alle verzoeken aan de Aniva Partner API moeten je partner-API-sleutel bevatten in de requestheader x-api-key.
Neem contact op met Aniva om je API-sleutel op te vragen. Sleutels worden per partneraccount uitgegeven.

Geauthenticeerde verzoeken versturen

Neem de x-api-key-header op in elk verzoek aan de API.

Foutresponsen

Als je verzoek geen x-api-key-header bevat, antwoordt de API met 401 Unauthorized.
Als de API-sleutel niet geldig is, antwoordt de API met 401 Unauthorized.
Als de sleutel geldig is, maar niet de scope voor het endpoint heeft, antwoordt de API met 403 Forbidden.
Als je een van deze fouten krijgt, controleer dan of:
  1. Je verzoek de x-api-key-header bevat.
  2. De waarde van de API-sleutel klopt en niet is geroteerd.
  3. Je sleutel de scope heeft die het endpoint vereist. Elk endpoint in de API-referentie vermeldt zijn scope.
Zet je API-sleutel nooit in client-side code of openbare repositories. Behandel hem als een wachtwoord.
Neem contact op met Aniva om een gecompromitteerde sleutel te roteren of om wijzigingen in de rechten van je API-sleutel aan te vragen.