Guida dell’API di Query Service

Questa guida per gli sviluppatori descrive i passaggi necessari per eseguire varie operazioni in Adobe Experience Platform Query Service API.

Introduzione

Questa guida richiede una buona comprensione dei vari servizi Adobe Experience Platform che utilizzano Query Service.

  • Query Service: Consente di eseguire query sui set di dati e acquisire le query risultanti come nuovi set di dati in Experience Platform.
  • Experience Data Model (XDM) System: Il quadro standardizzato Experience Platform organizza i dati sulla customer experience.
  • Sandboxes: Experience Platform fornisce sandbox virtuali che suddividono un singolo Platform in ambienti virtuali separati per sviluppare e sviluppare applicazioni di esperienza digitale.

Le sezioni seguenti forniscono informazioni aggiuntive che sarà necessario conoscere per utilizzare correttamente Query Service utilizzando l’API .

Lettura di chiamate API di esempio

Questa guida fornisce esempi di chiamate API per dimostrare come formattare le richieste. Questi includono percorsi, intestazioni richieste e payload di richiesta formattati correttamente. Viene inoltre fornito un esempio di codice JSON restituito nelle risposte API. Per informazioni sulle convenzioni utilizzate in questa documentazione per le chiamate API di esempio, consulta la sezione sulle come leggere le chiamate API di esempio in Experience Platform guida alla risoluzione dei problemi.

Raccogli i valori delle intestazioni richieste

Per effettuare chiamate a Experience Platform API, devi prima completare l’ esercitazione sull'autenticazione. Il completamento dell’esercitazione sull’autenticazione fornisce i valori per ciascuna delle intestazioni richieste in tutte le Platform Chiamate API, come mostrato di seguito:

  • Authorization: Bearer {ACCESS_TOKEN}
  • x-api-key: {API_KEY}
  • x-gw-ims-org-id: {ORG_ID}

Tutte le risorse in Experience Platform sono isolate in sandbox virtuali specifiche. Tutte le richieste a Platform Le API richiedono un’intestazione che specifichi il nome della sandbox in cui avrà luogo l’operazione:

  • x-sandbox-name: {SANDBOX_NAME}
NOTA

Per ulteriori informazioni sulle operazioni con le sandbox in Experience Platform, vedi documentazione panoramica sulle sandbox.

Chiamate API di esempio

Ora che capisci quali intestazioni utilizzare, sei pronto per iniziare a effettuare chiamate a Query Service API. Nei documenti seguenti vengono descritte le varie chiamate API che è possibile effettuare utilizzando Query Service API. Ogni chiamata di esempio include il formato API generale, una richiesta di esempio che mostra le intestazioni richieste e una risposta di esempio.

Passaggi successivi

Ora che hai imparato a fare chiamate utilizzando il Query Service È possibile creare query non interattive personalizzate. Per ulteriori informazioni su come creare le query, leggere il Guida di riferimento SQL.

In questa pagina