Hoe te beginnen?
Om te beginnen met de consentmanager API, neem contact op met uw accountmanager voor het volgende:
- Eindpunt-URL
- API sleutel
- Toegangstype-ID
Houd er rekening mee dat de REST API (anders dan de JS-API) is niet bij alle pakketten inbegrepen.
Waar is de REST-API voor?
Typische taken voor de REST API zijn onder meer:
- Automatisering van accountbeheer, bijvoorbeeld:
- CMP's maken en bijwerken
- Ontwerpen en teksten bijwerken
- Leveranciers toewijzen
- ...
- Automatisering van rapportage, bijvoorbeeld:
- Rapporten ophalen
- Protocollen trekken
De REST API kan niet worden gebruikt voor:
- Je kunt niet informatie ophalen over de toestemming van een specifieke gebruiker ("Heeft deze gebruiker geaccepteerd?").
- Je kunt niet IAB TCF-informatie verkrijgen
- Je kunt niet de toestemmingsstatus van de leverancier verkrijgen
Gebruik voor alle bovenstaande gebruiksscenario's in plaats daarvan de JS API.
OpenAPI 3 (OAS3)-specificatie
De API biedt een OAS3-specificatie zodra u bent geverifieerd. Hier is een voorbeeldworkflow met Swagger:
- Open Swagger en laad https://[Endpoint-URL]/info
- Vouw de actie uit autorisatie > autorisatie en klik op Probeer het
- Voer uw toegangstype en API-sleutel in en voer deze uit:
- U ontvangt uw inlogtoken. Kopieer het token en gebruik het om een nieuwe OAS3-specificatie aan te vragen:
- De geverifieerde OAS3-specificatie geeft u alle modellen en acties die toegankelijk zijn:
- Gebruik het autorisatiepictogram aan de rechterkant om uw logintoken toe te voegen:
- Nu kunt u de acties rechtstreeks in Swagger uitvoeren