Autenticazione e accesso all’API di Reactor
Per utilizzare il API di Reactor per creare e gestire le estensioni Tag, ogni richiesta deve includere le seguenti intestazioni di autenticazione:
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 le Ottieni accesso utente , torna a questa esercitazione per generare le credenziali specifiche dell’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}
ID della tua organizzazione ({ORG_ID}
) e chiave API ({API_KEY}
) possono essere riutilizzate nelle chiamate API future dopo che sono state generate inizialmente. 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 EXPERIENCI PLATFORM LAUNCH dall’elenco delle API disponibili prima di selezionare Successivo.
Quindi, seleziona il tipo di autenticazione per generare token di accesso e accedere all’API Experienci 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, la API EXPERIENCI PLATFORM Nella pagina del progetto vengono visualizzate le seguenti credenziali necessarie in tutte le chiamate alle API Experienci Platform:
{API_KEY}
(ID client){ORG_ID}
(ID organizzazione)
Generare un token di accesso generate-access-token
Il passaggio successivo consiste nel generare un {ACCESS_TOKEN}
credenziali da utilizzare nelle chiamate API di Platform. A differenza dei valori per {API_KEY}
e {ORG_ID}
, per continuare a utilizzare le API di Platform, è necessario generare un nuovo token ogni 24 ore.
È 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 > OAuth Server-to-Server 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, consulta la sezione su utilizzo di Postman per autenticare e testare le chiamate API nella guida di autenticazione API di Experienci Platform.
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 esempi di chiamate API 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: