Configurare Console sviluppatori e Postman

In questa lezione, configurerai un progetto nella console Adobe Developer e lo scaricherai Postman affinché tu possa iniziare a utilizzare le API di Platform.

Per completare gli esercizi API descritti in questa esercitazione, scarica l’app Postman per il tuo sistema operativo. Anche se non è necessario per utilizzare le API Experience Platform, Postman semplifica i flussi di lavoro API e Adobe Experience Platform fornisce decine di raccolte Postman per aiutarti a eseguire chiamate API e a imparare come funzionano. Il resto di questo tutorial presuppone una certa conoscenza operativa di Postman. Per assistenza, fai riferimento a Documentazione di Postman.

La piattaforma è stata creata prima in base alle API. Sebbene esistano opzioni di interfaccia anche per tutte le attività principali, a un certo punto potresti voler utilizzare l’API di Platform. Ad esempio, per acquisire i dati, spostare gli elementi da una sandbox all’altra, automatizzare le attività di routine o utilizzare le nuove funzioni di Platform prima che l’interfaccia utente sia stata generata.

Architetti di dati e Ingegneri dati potrebbe essere necessario utilizzare l’API di Platform al di fuori di questa esercitazione.

Autorizzazioni richieste

In Configurare le autorizzazioni Per completare questa lezione, è necessario impostare tutti i controlli di accesso necessari.

Configurare la console Adobe Developer

La console Adobe Developer è la destinazione per sviluppatori che consente di accedere a API e SDK Adobe, ascoltare eventi in tempo reale, eseguire funzioni in fase di esecuzione o creare plug-in o applicazioni App Builder. Lo utilizzerai per accedere all’API Experience Platform. Per ulteriori dettagli, vedi Documentazione della console Adobe Developer

  1. Crea una cartella sul computer locale denominata Luma Tutorial Assets per i file utilizzati nell’esercitazione.

  2. Apri Console Adobe Developer

  3. Accedi e verifica di essere nell’organizzazione corretta

  4. Seleziona Crea nuovo progetto in Guida rapida menu.

    Crea nuovo progetto

  5. Nel progetto appena creato, seleziona la Modifica Progetto pulsante

  6. Modificare il Titolo progetto a Luma Tutorial API Project (aggiungi il tuo nome alla fine, se più persone della tua azienda stanno seguendo questo tutorial)

  7. Seleziona Salva

    Configurazione API progetto console Adobe Developer

  8. Seleziona Aggiungi API

    Configurazione API progetto console Adobe Developer

  9. Filtra l’elenco selezionando Adobe Experience Platform

  10. Nell’elenco delle API disponibili, seleziona API EXPERIENCE PLATFORM e seleziona Successivo.

    Configurazione API progetto console Adobe Developer

  11. Seleziona OAuth Server-to-Server come credenziali e seleziona Successivo.
    Seleziona server-to-server OAuth

  12. Seleziona la AEP-Default-All-Users profilo di prodotto e seleziona Salva API configurata

    Seleziona profilo prodotto

  13. Ora il progetto Console sviluppatori è stato creato.

  14. In Provatelo sezione della pagina, seleziona Scarica per Postman e quindi seleziona OAuth Server-to-Server per scaricare Postman file json dell’ambiente. Salva il oauth_server_to_server.postman_environment.json nel tuo Luma Tutorial Assets cartella.

    Configurazione API progetto console Adobe Developer

Chiedi a un amministratore di sistema di aggiungere le credenziali API al ruolo

Per utilizzare le credenziali API per interagire con Experience Platform, è necessario che un amministratore di sistema assegni le credenziali API al ruolo creato nella lezione precedente. Se non sei un amministratore di sistema, puoi inviarli:

  1. Il Nome delle credenziali API (Credential in Luma Tutorial API Project)

  2. Il E-mail account tecnico delle credenziali (in questo modo l’amministratore di sistema potrà trovare le credenziali)

    Nome e E-mail account tecnico delle credenziali

Seguono le istruzioni per l’amministratore di sistema:

  1. Accedi a Adobe Experience Platform

  2. Seleziona Autorizzazioni nella barra di navigazione a sinistra, che consente di accedere al Ruoli screen

  3. Apri Luma Tutorial Platform ruolo
    Apri il ruolo

  4. Seleziona la Credenziali API scheda

  5. Seleziona Aggiungi credenziali API
    Aggiungi credenziali

  6. Trova il Credential in Luma Tutorial API Project credenziali, filtro con E-mail account tecnico fornito dal partecipante all’esercitazione, se l’elenco è lungo

  7. Seleziona le credenziali

  8. Seleziona Salva

    Aggiungi credenziali

Configurare Postman

CAUTION
L’interfaccia di Postman viene aggiornata regolarmente. Le schermate di questo tutorial sono state scattate con Postman v10.15.1 per Mac, ma le opzioni dell’interfaccia potrebbero essere cambiate.
  1. Scarica e installa Postman

  2. Apri Postman e creare un’area di lavoro
    Importa ambiente

  3. Importare il file di ambiente json scaricato oauth_server_to_server.postman_environment.json
    Importa ambiente

  4. In entrata Postman, seleziona l’ambiente nel menu a discesa

  5. Seleziona l’icona per visualizzare le variabili di ambiente:

    Cambia ambiente

Aggiungere il nome della sandbox e l’ID tenant

Il SANDBOX_NAME e TENANT_ID e CONTAINER_ID Le variabili non sono incluse nell’esportazione della console Adobe Developer, per cui le aggiungiamo manualmente:

  1. In entrata Postman, apri Variabili di ambiente

  2. Seleziona la Modifica collegamento a destra del nome dell’ambiente

  3. In Aggiungi nuovo campo variabile, immetti SANDBOX_NAME

  4. In entrambi i campi valore, immetti luma-tutorial, il nome che abbiamo dato alla sandbox nella lezione precedente. Se hai utilizzato un nome diverso per la sandbox, ad esempio luma-tutorial-ignatiusjreilly, assicurati di utilizzare tale valore.

  5. In Aggiungi nuovo campo variabile, immetti TENANT_ID

  6. Passa al browser web e cerca l’ID tenant della tua azienda andando nell’interfaccia di Experience Platform ed estraendo la porzione dell’URL dopo il simbolo @. Ad esempio, il mio ID tenant è techmarketingdemos ma il tuo è diverso:

    Ottenere l’ID tenant dall’URL dell’interfaccia di Platform

  7. Copia questo valore e torna al Postman Schermata Gestisci ambienti

  8. Incolla l’ID tenant in entrambi i campi valore

  9. In Aggiungi nuovo campo variabile, immetti CONTAINER_ID

  10. Invio global in entrambi i campi valore

    note note
    NOTE
    CONTAINER_ID è un campo il cui valore viene modificato più volte durante l’esercitazione. Quando global interagisce con gli elementi forniti da Adobe nell’account Platform. Quando tenant Se viene utilizzato, l’API interagisce con i tuoi elementi personalizzati.
  11. Seleziona Salva

    Campi SANDBOX_NAME, TENANT_ID e CONTAINER_ID aggiunti come variabili di ambiente

Effettuare chiamate API

Recuperare un token di accesso

Adobe fornisce un set completo di Postman raccolte per esplorare le API di Experience Platform. Queste raccolte sono nel Adobe Experience Platform Postman: esempi di archivio GitHub. Applica un segnalibro a questo archivio, in quanto lo utilizzerai numerose volte durante questa esercitazione e in seguito durante l’implementazione di Experience Platform per la tua azienda.

La prima raccolta funziona con le API Adobe Identity Management Service (IMS). È un modo pratico per recuperare un token di accesso da Postman.

Per generare il token di accesso:

  1. Scarica il file Raccolta API del servizio Identity Management al tuo Luma Tutorial Assets cartella

  2. Importa la raccolta in Postman

  3. Seleziona la richiesta oAuth: richiedi token di accesso richiedi e seleziona Invia

  4. Dovresti ricevere un 200 OK risposta con un token di accesso nella risposta

    Richiedere i token

  5. Il token di accesso deve essere memorizzato automaticamente come ACCESS_TOKEN variabile di ambiente del Postman ambiente.

    Postman

Interagire con un’API di Platform

Effettuiamo ora una chiamata API Platform per confermare che tutto è stato configurato correttamente.

Apri Experience Platform Postman raccolte in GitHub. In questa pagina sono presenti molte raccolte, per diverse API di Platform. Raccomando vivamente di segnalibro.

Ora effettuiamo la nostra prima chiamata API:

  1. Scarica il file Raccolta API del registro dello schema al tuo Luma Tutorial Assets cartella
  2. Importa in Postman
  3. Apri Schema Registry API > Schemi > Elenca schemi
  4. Osserva la Parametri e Intestazioni e annota come includono alcune delle variabili di ambiente immesse in precedenza.
  5. Tieni presente che Intestazioni > Campo Accetta valore è impostato su application/vnd.adobe.xed-id+json. Le API del registro dello schema richiedono una di queste valori di intestazione Accept specificati che forniscono formati diversi nella risposta.
  6. Seleziona Invia per effettuare la tua prima chiamata API Platform.

Speriamo che tu abbia avuto successo 200 OK risposta contenente un elenco degli schemi XDM forniti dall’Adobe disponibili nella sandbox, come illustrato di seguito.

Prima chiamata API in Postman

Se la chiamata non ha avuto esito positivo, attendi un attimo a eseguire il debug utilizzando i dettagli della risposta di errore della chiamata API e controlla i passaggi precedenti. Se si blocca, richiedere assistenza nella Forum della community In alternativa, utilizza il collegamento sul lato destro della pagina per "Segnalare un problema".

Con le autorizzazioni della piattaforma, la sandbox e Postman , è possibile eseguire le operazioni seguenti: dati modello negli schemi!

recommendation-more-help
513160b6-bf42-4c58-abdd-4f817b1cccad