Configurazione dell’accesso alle API setting-up-api-access
L’accesso alle API di Adobe Campaign Standard è configurato attraverso i passaggi seguenti. Ognuno di questi passaggi è descritto nella documentazione di Adobe Developer.
-
Verifica di disporre di un certificato digitale oppure creane uno, se necessario. Le chiavi pubbliche e private fornite con il certificato sono necessarie nei passaggi seguenti.
-
Crea una nuova integrazione con il servizio Adobe Campaign in Adobe Developer e configuralo. Quindi saranno generate le credenziali (chiave API, segreto client…).
-
Crea una credenziale da server a server OAuth seguendo questi passaggi di implementazione
note important IMPORTANT Il codice JWT (JSON Web Tokens) è attualmente in fase di ammortamento e viene sostituito con OAuth. La transizione viene eseguita progressivamente nelle prossime versioni di Campaign. Le credenziali dell’account di servizio (JWT) sono state contrassegnate come obsolete e continueranno a funzionare fino al 27 gennaio 2025. Pertanto, è necessario migrare l’applicazione o l’integrazione per utilizzare le nuove credenziali server-to-server OAuth prima del 27 gennaio 2025. È preferibile l’autenticazione OAuth. Troverai tutti gli elementi per migrare dall’autenticazione JWT all’autenticazione OAuth in queste pagine:
Per stabilire una sessione API di Adobe I/O servizio-servizio sicura, ogni richiesta a un servizio di Adobe deve includere nell’intestazione dell’autorizzazione le informazioni riportate di seguito.
-X GET https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServices/profile \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-H 'Cache-Control: no-cache' \
-H 'X-Api-Key: <API_KEY>'
-
<ORGANIZZAZIONE>: questo è il tuo ID organizzazione personale; per Adobe viene fornito un ID organizzazione per ciascuna istanza:
- <ORGANIZZAZIONE> : l’istanza di produzione,
- <ORGANIZATION-market-stage>: l’istanza di stage.
Per ottenere il valore dell’ID organizzazione, rivolgiti all’amministratore o al contatto tecnico Adobe. Puoi anche recuperarlo in Adobe I/O durante la creazione di una nuova integrazione, nell'elenco delle licenze (consulta la documentazione di Adobe Developer).
-
<ACCESS_TOKEN>: token di accesso personale recuperato durante lo scambio del token Web JSON tramite una richiesta POST.
-
<API_KEY>: la tua chiave API personale. Viene fornito in Adobe I/O dopo la creazione di una nuova integrazione con il servizio Adobe Campaign.
Risoluzione dei problemi
Durante l’integrazione Adobe IO, se viene visualizzato il seguente errore:
{
"code": 502,
"message": "Oops. Something went wrong. Check your URI and try again."
}
Per verificare se il parametro CNAME è stato creato correttamente, rivolgiti al tuo amministratore o al contatto tecnico Adobe.