Questa guida fornisce un’introduzione ai concetti di base che è necessario conoscere prima di tentare di effettuare chiamate all’API di Adobe Experience Platform Privacy Service.
Questa guida richiede una buona conoscenza di Privacy Service e come consente di gestire le richieste di accesso ed eliminazione da parte degli interessati (clienti) in tutte le applicazioni Adobe Experience Cloud.
Per creare le credenziali di accesso per l’API, un amministratore dell’organizzazione deve aver precedentemente configurato i profili di prodotto per Privacy Service in Adobe Admin Console. Il profilo di prodotto assegnato a un’integrazione API determina di quali autorizzazioni dispone l’integrazione quando si accede alle funzionalità di Privacy Service. Consulta la guida su gestione delle autorizzazioni di Privacy Service per ulteriori informazioni.
Per effettuare chiamate all’API Privacy Service, devi innanzitutto raccogliere le credenziali di accesso da utilizzare nelle intestazioni richieste:
Authorization: Bearer {ACCESS_TOKEN}
x-api-key: {API_KEY}
x-gw-ims-org-id: {ORG_ID}
Questi valori vengono generati utilizzando Console Adobe Developer. Il tuo {ORG_ID}
e {API_KEY}
deve essere generato una sola volta e può essere riutilizzato nelle chiamate API future. Tuttavia, {ACCESS_TOKEN}
è temporaneo e deve essere rigenerato ogni 24 ore.
I passaggi per generare questi valori sono descritti in dettaglio di seguito.
Vai a Adobe Developer Console e accedi con il tuo Adobe ID. Quindi, segui i passaggi descritti nel tutorial su come creare un progetto vuoto, nella documentazione di Developer Console.
Dopo aver creato un nuovo progetto, seleziona Aggiungi al progetto e scegli API dal menu a discesa.
Viene visualizzata la schermata Add an API (Aggiungi un’API). Seleziona Experience Cloud per limitare l’elenco delle API disponibili, seleziona la scheda per API PRIVACY SERVICE prima di selezionare Successivo.
Il Configurare API viene visualizzata la schermata. Seleziona l’opzione per Generare una coppia di chiavi, quindi seleziona Genera coppia di chiavi.
La coppia di chiavi viene generata automaticamente e un file ZIP contenente una chiave privata e un certificato pubblico viene scaricato dal browser (da utilizzare in un passaggio successivo). Seleziona Next (Avanti) per continuare.
Il passaggio finale della configurazione consiste nel selezionare i profili di prodotto da cui questa integrazione erediterà le relative autorizzazioni. Se selezioni più di un profilo, i relativi set di autorizzazioni verranno combinati per l’integrazione.
I profili di prodotto e le autorizzazioni granulari che forniscono vengono creati e gestiti dagli amministratori tramite Adobe Admin Console. Consulta la guida su Autorizzazioni Privacy Service per ulteriori informazioni.
Al termine, seleziona Salva API configurata.
Una volta aggiunta l’API al progetto, la pagina del progetto viene visualizzata di nuovo sul Panoramica API di Privacy Service pagina. Da qui, scorri verso il basso fino a Account di servizio (JWT) , che fornisce le seguenti credenziali di accesso necessarie in tutte le chiamate all’API Privacy Service:
{API_KEY}
che devono essere fornite nella x-api-key
intestazione.{ORG_ID}
che deve essere utilizzato nell’intestazione x-gw-ims-org-id
.L'ultima credenziale richiesta da raccogliere è la tua {ACCESS_TOKEN}
, utilizzato nell’intestazione Autorizzazione. A differenza dei valori per {API_KEY}
e {ORG_ID}
, per continuare a utilizzare l’API è necessario generare un nuovo token ogni 24 ore.
In generale, esistono due metodi per generare un token di accesso:
Per generare manualmente un nuovo {ACCESS_TOKEN}
, apri la chiave privata scaricata in precedenza e incollane il contenuto nella casella di testo accanto Genera token di accesso prima di selezionare Genera token.
Viene generato un nuovo token di accesso, e un pulsante consente di copiarlo negli Appunti. Questo valore viene utilizzato per l’intestazione Autorizzazione richiesta e deve essere fornito nel formato Bearer {ACCESS_TOKEN}
.
Puoi generare nuovi token di accesso per i processi automatizzati inviando un token web JSON (JWT) tramite una richiesta POST ad Adobe Identity Management Service (IMS). Consulta il documento Console sviluppatori su Autenticazione JWT per i passaggi dettagliati.
Ogni guida dell’endpoint fornisce esempi di chiamate API per dimostrare come formattare le richieste. Questi includono percorsi, intestazioni richieste e payload di richieste formattati correttamente. Viene inoltre fornito il codice JSON di esempio restituito nelle risposte API. Per informazioni sulle convenzioni utilizzate nella documentazione per le chiamate API di esempio, consulta la sezione su come leggere esempi di chiamate API nella guida introduttiva per le API di Platform.
Ora che sai quali intestazioni utilizzare, puoi iniziare a effettuare chiamate all’API Privacy Service. Seleziona una delle guide endpoint per iniziare: