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. Puoi esplorare e navigare nei file dall’interno della tua origine utilizzando l’ID connessione di base. Inoltre, puoi identificare gli elementi specifici che desideri acquisire, compresi i dettagli sui tipi di dati e i formati di tali elementi.

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

Formato API

POST /connections

Richiesta

La richiesta seguente crea una connessione di base per Stripe:

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": "Stripe base connection",
      "description": "Authenticated base connection for Stripe",
      "connectionSpec": {
          "id": "cc2c31d6-7b8c-4581-b49f-5c8698aa3ab3",
          "version": "1.0"
      },
      "auth": {
          "specName": "OAuth2 Refresh Code",
          "params": {
            "accessToken": "{ACCESS_TOKEN}",
          }
      }
  }'
ProprietàDescrizione
nameNome della connessione di base. Verificare che il nome della connessione di base sia descrittivo, in quanto è possibile utilizzarlo per cercare informazioni sulla connessione di base.
descriptionValore facoltativo che è possibile includere per fornire ulteriori informazioni sulla connessione di base.
connectionSpec.idID della specifica di connessione dell'origine. L'ID della specifica di connessione per Stripe è cc2c31d6-7b8c-4581-b49f-5c8698aa3ab3 e questo ID è corretto.
auth.specNameTipo di autenticazione utilizzato per autenticare l’origine in Experience Platform.
auth.params.accessTokenToken di accesso dell'account Stripe. Leggi la Stripe guida all'autenticazione per i passaggi su come recuperare il token di accesso.

Risposta

In caso di esito positivo, la risposta restituisce la connessione di base appena creata, incluso il relativo identificatore univoco di connessione (id). Questo ID è necessario per esplorare la struttura e il contenuto del file sorgente nel passaggio successivo.

{
  "id": "a9950001-a386-4642-a0cd-5eaac6db5556",
  "etag": "\"dc01244d-0000-0200-0000-65ea4e500000\""
}