Creare una connessione di base PathFactory utilizzando l'API Flow Service

4 aprile 2025

Argomenti:

Creato per:

Sviluppatore

Una connessione di base rappresenta la connessione autenticata tra un'origine e Adobe Experience Platform.

Leggi questo documento per scoprire come creare una connessione di base per PathFactory utilizzando Flow Service API.

Introduzione

Questa guida richiede una buona conoscenza dei seguenti componenti di Experience Platform:

Origini: Experience Platform consente di acquisire dati da varie origini e allo stesso tempo di strutturare, etichettare e migliorare i dati in arrivo tramite i servizi Experience Platform.
Sandbox: Experience Platform fornisce sandbox virtuali che suddividono una singola istanza Experience Platform in ambienti virtuali separati, utili per le attività di sviluppo e aggiornamento delle applicazioni di esperienza digitale.

Utilizzo delle API di Experience Platform

Per informazioni su come effettuare correttamente chiamate alle API di Experience Platform, consulta la guida introduttiva alle API di Experience Platform.

La sezione seguente fornisce informazioni aggiuntive che è necessario conoscere per connettersi correttamente a PathFactory utilizzando l'API Flow Service.

Raccogli credenziali richieste

Per accedere all’account PathFactory in Experience Platform, è necessario fornire i seguenti valori:

Credenziali

Descrizione

Nome utente

Nome utente dell'account PathFactory. Questo è essenziale per identificare l’account nel sistema.

Password

La password associata al tuo account PathFactory. Assicurati che sia protetto per evitare accessi non autorizzati.

Dominio

Il dominio associato al tuo account PathFactory. In genere si riferisce all'identificatore univoco all'interno dell'URL PathFactory.

Token di accesso

Token univoco utilizzato per l'autenticazione API per garantire una comunicazione sicura tra i sistemi e PathFactory.

Endpoint API

Endpoint API specifici per l’accesso ai dati: visitatori, sessioni e visualizzazioni di pagina. Ogni endpoint corrisponde a set di dati diversi che è possibile recuperare. Nota: questi sono predefiniti da PathFactory e sono specifici per i dati a cui intendi accedere:

Endpoint visitatori: /api/public/v3/data_lake_apis/visitors.json
Endpoint sessioni: /api/public/v3/data_lake_apis/sessions.json
Endpoint visualizzazioni pagina: /api/public/v3/data_lake_apis/page_views.json

Per ulteriori informazioni su come proteggere e utilizzare le credenziali, nonché su come ottenere e aggiornare il token di accesso, visitare il PathFactory Centro assistenza. Questa risorsa offre guide complete sulla gestione delle credenziali e sulla garanzia di un’integrazione API efficace e sicura.

Creare una connessione di base

Una connessione di base mantiene le informazioni tra l’origine e Experience Platform, incluse le credenziali di autenticazione dell’origine, lo stato corrente della connessione e l’ID univoco della connessione di base. L’ID della connessione di base consente di esplorare e navigare tra i file dall’interno dell’origine e identificare gli elementi specifici che desideri acquisire, comprese le informazioni relative ai tipi di dati e ai formati.

Per creare un ID di connessione di base, eseguire una richiesta POST all'endpoint /connections fornendo le credenziali di autenticazione PathFactory come parte del corpo della richiesta.

Formato API

POST /connections

Richiesta

La richiesta seguente crea una connessione di base per PathFactory:

curl -X POST \
  'https://platform.adobe.io/data/foundation/flowservice/connections' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
      "name": "PathFactory base connection",
      "description": "PathFactory base connection",
      "auth": {
          "specName": "Basic Authentication",
          "params": {
              "host": "acme-ab12c3d4e5fg6hijk7lmnop8qrst"
              "clientId": "pathfactory",
              "clientSecret": "xxxx"
          }
      },
      "connectionSpec": {
          "id": "ea1c2a08-b722-11eb-8529-0242ac130003",
          "version": "1.0"
      }
  }'

Proprietà

Descrizione

auth.params.clientId

L'ID client associato all'applicazione PathFactory.

auth.params.clientSecret

Il segreto client associato all'applicazione PathFactory.

connectionSpec.id

ID della specifica di connessione PathFactory: ea1c2a08-b722-11eb-8529-0242ac130003.

Risposta

In caso di esito positivo, la risposta restituisce la connessione appena creata, incluso l'identificatore univoco (id). Questo ID è necessario per esplorare i dati nell’esercitazione successiva.

{
    "id": "2fce94c1-9a93-4971-8e94-c19a93097129",
    "etag": "\"d403848a-0000-0200-0000-5e978f7b0000\""
}

Passaggi successivi

Seguendo questa esercitazione, è stata creata una connessione di base PathFactory utilizzando l'API Flow Service. Puoi utilizzare questo ID connessione di base nelle seguenti esercitazioni:

recommendation-more-help