Guida introduttiva a REST APIs getting-started-with-rest-apis

Panoramica di Adobe Developer adobeio

Adobe Developer è l’ecosistema e la comunità di sviluppatori di Adobe. Include API per tutti i prodotti Adobe.

Si tratta del metodo consigliato per impostare e utilizzare Adobe APIs.

Prerequisiti prerequisites

Prima di configurare JWT autenticazione, assicurati di avere accesso al Console Adobe Developer in Adobe Developer. Contatta l’amministratore dell’organizzazione per le richieste di accesso.

Autenticazione auth

Segui i passaggi seguenti per configurare JWT (Service Account) autenticazione tramite Adobe Developer:

1. Accedi a Console Adobe Developer.
2. Segui i passaggi descritti in Connessione account di servizio.
   • Durante Passaggio 2: aggiungi un’API al progetto utilizzando l’autenticazione dell’account di servizio, scegli il Audience Manager API opzione.
3. Prova la connessione effettuando la prima API effettua una chiamata in base alle istruzioni Passaggio 3.

Autorizzazioni RBAC dell’account tecnico

Se il tuo account di Audience Manager utilizza Controllo degli accessi basato sul ruolo, devi creare un account utente tecnico Audienci Manager e aggiungerlo al gruppo RBAC Audienci Manager che effettuerà le chiamate API.

Per creare un account utente tecnico e aggiungerlo a un gruppo RBAC, effettua le seguenti operazioni:

1. Crea un GET chiama a https://aam.adobe.io/v1/users/self. La chiamata creerà un account utente tecnico che potrai visualizzare nella Admin Console, nella Users pagina.

   

2. Accedi al tuo account Audienci Manager e aggiungere l’account utente tecnico al gruppo di utenti che effettuerà le chiamate API.

Il Audience Manager REST API segue OAuth 2.0 standard per l’autenticazione e il rinnovo dei token. Le sezioni seguenti descrivono come eseguire l’autenticazione e iniziare a utilizzare APIs.

Crea un generico API Utente requirements

È consigliabile creare un account utente tecnico separato per l'utilizzo di Audience Manager APIs. Si tratta di un account generico non associato o associato a un utente specifico dell'organizzazione. Questo tipo di API l’account utente ti consente di eseguire 2 operazioni:

• Identifica il servizio che chiama API (ad esempio, chiamate dalle app che utilizzano il nostro APIs o da altri strumenti che API richieste).
• Fornire accesso ininterrotto al APIs. Un account associato a una persona specifica può essere cancellato quando lascia la tua azienda. Questo ti impedirà di lavorare con i API codice. Un account generico non legato a un dipendente specifico consente di evitare questo problema.

Come esempio o caso d’uso per questo tipo di account, supponiamo che tu voglia modificare molti segmenti contemporaneamente con Strumenti di gestione in blocco. Bene, per fare questo, il tuo account utente ha bisogno di API accesso. Invece di aggiungere le autorizzazioni a un utente specifico, crea un’ API account utente con credenziali, chiave e segreto appropriati API chiamate. Questa funzione è utile anche per sviluppare applicazioni personalizzate che utilizzano Audience Manager APIs.

Utilizzare Audience Manager consulente per la creazione di un generico, APIaccount utente di sola lettura.

Flusso di lavoro di autenticazione password password-authentication-workflow

Autenticazione tramite password accesso sicuro REST API. I passaggi seguenti descrivono il flusso di lavoro per l’autenticazione tramite password da un JSON nel browser.

Passaggio 1: richiesta API Accesso

Contatta il tuo Partner Solutions Manager. Ti forniranno un API ID client e segreto. L’ID e il segreto ti autenticano nel API.

Nota: se desideri ricevere un token di aggiornamento, specificalo quando richiedi API accesso.

Passaggio 2: richiedere il token

Passa una richiesta di token con il tuo preferito JSON client. Quando crei la richiesta:

• Utilizza un POST metodo di chiamata https://api.demdex.com/oauth/token.
• Converti l’ID client e il segreto in una stringa con codifica base 64. Durante il processo di conversione, separa l’ID e il segreto con due punti. Ad esempio, le credenziali testId : testSecret convertire in dGVzdElkOnRlc3RTZWNyZXQ=.
• Passa il HTTP headers Authorization:Basic <base-64 clientID:clientSecret> e Content-Type: application/x-www-form-urlencoded . Ad esempio, l’intestazione potrebbe essere simile alla seguente:
  Authorization: Basic dGVzdElkOnRlc3RTZWNyZXQ=
Content-Type: application/x-www-form-urlencoded
• Imposta il corpo della richiesta come segue:
  
  grant_type=password&username=<your-AudienceManager-user-name>&password=<your-AudienceManager-password>

Passaggio 3: ricevere il token

Il JSON la risposta contiene il token di accesso. La risposta deve essere simile alla seguente:

{
    "access_token": "28fed402-eafd-456c-9341-ac753f25bbbc",
    "token_type": "bearer",
    "refresh_token": "b27122c0-b0c7-4b39-a71b-1547a3b3b88e",
    "expires_in": 21922,
    "scope": "read write"
}

Il expires_in key rappresenta il numero di secondi rimanenti alla scadenza del token di accesso. Come best practice, utilizza tempi di scadenza brevi per limitare l’esposizione se il token viene mai esposto.

Aggiorna token refresh-token

Aggiorna token di rinnovo API dopo la scadenza del token originale. Se richiesto, la risposta JSON nel flusso di lavoro della password è incluso un token di aggiornamento. Se non ricevi un token di aggiornamento, creane uno nuovo tramite il processo di autenticazione tramite password.

Puoi anche utilizzare un token di aggiornamento per generare un nuovo token prima della scadenza del token di accesso esistente.

Se il token di accesso è scaduto, viene visualizzato un messaggio 401 Status Code e la seguente intestazione nella risposta:

WWW-Authenticate: Bearer realm="oauth", error="invalid_token", error_description="Access token expired: <token>"

I passaggi seguenti descrivono il flusso di lavoro per l’utilizzo di un token di aggiornamento per creare un nuovo token di accesso da un JSON nel browser.

Passaggio 1: richiesta del nuovo token

Trasmettere una richiesta di token di aggiornamento con il token preferito JSON client. Quando crei la richiesta:

• Utilizza un POST metodo di chiamata https://api.demdex.com/oauth/token.
• Converti l’ID client e il segreto in una stringa con codifica base 64. Durante il processo di conversione, separa l’ID e il segreto con due punti. Ad esempio, le credenziali testId : testSecret convertire in dGVzdElkOnRlc3RTZWNyZXQ=.
• Passa le intestazioni HTTP Authorization:Basic <base-64 clientID:clientSecret> e Content-Type: application/x-www-form-urlencoded. Ad esempio, l’intestazione potrebbe essere simile alla seguente:
  Authorization: Basic dGVzdElkOnRlc3RTZWNyZXQ=
Content-Type: application/x-www-form-urlencoded
• Nel corpo della richiesta, specifica grant_type:refresh_token e passa il token di aggiornamento ricevuto nella richiesta di accesso precedente. La richiesta deve essere simile alla seguente:
  grant_type=refresh_token&refresh_token=b27122c0-b0c7-4b39-a71b-1547a3b3b88e

Passaggio 2: ricevere il nuovo token

Il JSON la risposta contiene il nuovo token di accesso. La risposta deve essere simile alla seguente:

{
    "access_token": "4fdfc261-2ffc-4fb7-8dbd-64221714c45f",
    "token_type": "bearer",
    "refresh_token": "295fa487-1825-4caa-a715-80b81ac17dae",
    "expires_in": 21922,
    "scope": "read write"
}

Codice di autorizzazione e autenticazione implicita authentication-code-implicit

Il Audience Manager REST API supporta il codice di autorizzazione e l’autenticazione implicita. Per utilizzare questi metodi di accesso, gli utenti devono accedere a https://api.demdex.com/oauth/authorize per accedere e aggiornare i token.