Per iniziare a utilizzare l'API di Consentmanager, contatta il tuo account manager per ottenere:
- Endpoint URL
- Chiave API
- ID tipo di accesso
Si prega di notare che l'API REST (diversa dall'API JS) non è inclusa in tutti i pacchetti.
A cosa serve l'API REST?
I compiti tipici dell'API REST includono:
- Automazione della gestione degli account, ad esempio:
- Creazione e aggiornamento delle CMP
- Aggiornamento di design e testi
- Assegnazione dei fornitori
- …
- Automazione della reportistica, ad esempio:
- Estrazione di report
- Estrazione di protocolli
L'API REST non può essere utilizzata per:
- Non puoi ricavare informazioni su un consenso specifico dell'utente ("Questo utente ha accettato?").
- Non è possibile ottenere le informazioni IAB TCF
- Non è possibile ottenere lo stato di consenso del fornitore
Per tutti i casi d'uso sopra indicati, utilizza invece l'API JS.
Specifiche OpenAPI 3 (OAS3)
L'API fornisce una specifica OAS3 una volta effettuata l'autenticazione. Ecco un esempio di flusso di lavoro che utilizza Swagger:
- Apri Swagger e carica https://[Endpoint-URL]/info
- Espandi l'azione auth > auth e clicca su Provalo
- Inserisci il tuo tipo di accesso e la chiave API ed esegui:
- Riceverai il tuo token di accesso. Copia il token e utilizzalo per richiedere una nuova specifica OAS3:
- La specifica OAS3 autenticata ti fornirà tutti i modelli e le azioni accessibili:
- Usa l'icona di autorizzazione a destra per aggiungere il tuo token di accesso:
- Ora puoi eseguire le azioni direttamente in Swagger