Autenticazione e accesso all’API di Reactor
Per utilizzare l'API Reactor per creare e gestire le estensioni Tag, ogni richiesta deve includere le intestazioni di autenticazione seguenti:
Authorization: Bearer {ACCESS_TOKEN}
x-api-key: {API_KEY}
x-gw-ims-org-id: {ORG_ID}
Questa guida illustra come utilizzare Adobe Developer Console per raccogliere i valori per ciascuna di queste intestazioni, in modo da poter iniziare a effettuare chiamate all’API di Reactor.
Accesso degli sviluppatori a Adobe Experience Platform gain-developer-access
Prima di poter generare i valori di autenticazione per l’API di Reactor, devi disporre dell’accesso ad Experience Platform come sviluppatore. Per ottenere l’accesso come sviluppatore, segui i passaggi iniziali descritti nel tutorial sull’autenticazione per Experience Platform. Dopo aver completato il passaggio Accesso utente, torna a questa esercitazione per generare le credenziali specifiche per l'API di Reactor.
Generare le credenziali di accesso generate-access-credentials
Utilizzando Adobe Developer Console, è necessario generare le tre credenziali di accesso seguenti:
{ORG_ID}
{API_KEY}
{ACCESS_TOKEN}
Una volta generati, l'ID organizzazione ({ORG_ID}
) e la chiave API ({API_KEY}
) possono essere riutilizzati nelle chiamate API future. Il token di accesso ({ACCESS_TOKEN}
) è invece temporaneo e deve essere rigenerato ogni 24 ore.
I passaggi per generare questi valori sono descritti in dettaglio di seguito.
Configurazione una tantum one-time-setup
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 progetto, seleziona Add API (Aggiungi API) nella schermata Project Overview (Panoramica progetto).
Viene visualizzata la schermata Add an API (Aggiungi un’API). Seleziona API di Experience Platform Launch dall'elenco delle API disponibili prima di selezionare Avanti.
Quindi, seleziona il tipo di autenticazione per generare token di accesso e accedere all’API Experience Platform.
Seleziona Avanti per continuare.
Nella schermata successiva viene richiesto di selezionare uno o più profili di prodotto da associare all’integrazione API.
Seleziona i profili di prodotto desiderati dall’elenco, quindi seleziona Save configured API (Salva API configurata) per completare la registrazione dell’API.
Raccogli le credenziali gather-credentials
Una volta aggiunta l'API al progetto, nella pagina Experience Platform API per il progetto vengono visualizzate le credenziali seguenti, necessarie in tutte le chiamate alle API Experience Platform:
{API_KEY}
(ID client){ORG_ID}
(ID organizzazione)
Generare un token di accesso generate-access-token
Il passaggio successivo consiste nel generare una credenziale {ACCESS_TOKEN}
da utilizzare nelle chiamate API di Platform. A differenza dei valori per {API_KEY}
e {ORG_ID}
, è necessario generare un nuovo token ogni 24 ore per continuare a utilizzare le API di Platform.
È possibile generare i token di accesso in due modi, a seconda del caso d’uso:
Generare manualmente i token di accesso manual
Per generare manualmente un nuovo {ACCESS_TOKEN}
, passa a Credenziali > Server-to-Server OAuth e seleziona Genera token di accesso, come illustrato di seguito.
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}
.
Generazione automatica dei token auto-token
Puoi inoltre utilizzare un ambiente e una raccolta Postman per generare i token di accesso. Per ulteriori informazioni, leggere la sezione relativa all'utilizzo di Postman per l'autenticazione e il test delle chiamate API nella guida di Experience Platform per l'autenticazione API.
Verifica credenziali API test-api-credentials
Seguendo i passaggi descritti in questo tutorial, dovresti disporre di valori validi per {ORG_ID}
, {API_KEY}
e {ACCESS_TOKEN}
. Ora puoi testare questi valori utilizzandoli in una semplice richiesta cURL all’API di Reactor.
Per prima cosa, prova ad effettuare una chiamata API per elencare tutte le aziende.
Una volta confermato il funzionamento delle credenziali di accesso, continua a esplorare il resto della documentazione sull’API per scoprirne le numerose funzionalità.
Lettura delle chiamate API di esempio read-sample-api-calls
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 un 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 chiamate API di esempio nella guida introduttiva per le API di Platform.
Passaggi successivi next-steps
Ora che sai quali intestazioni utilizzare, puoi iniziare a effettuare chiamate all’API di Reactor. Seleziona una delle guide endpoint per iniziare: