Een PathFactory basisverbinding maken met de Flow Service API

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Onderwerpen:

Gemaakt voor:

Ontwikkelaar

Een basisverbinding vertegenwoordigt de geverifieerde verbinding tussen een bron en Adobe Experience Platform.

Lees dit document om te leren hoe te om een basisverbinding voor PathFactory tot stand te brengen gebruikend [Flow Service API ] (https://www.adobe.io/experience-platform-apis/references/flow-service/).

Aan de slag

Deze handleiding vereist een goed begrip van de volgende onderdelen van het Experience Platform:

Bronnen: Experience Platform staat gegevens toe om van diverse bronnen worden opgenomen terwijl het voorzien van u van de capaciteit om, inkomende gegevens te structureren te etiketteren en te verbeteren gebruikend de diensten van het Platform.
Sandboxes: Experience Platform verstrekt virtuele zandbakken die één enkele instantie van het Platform in afzonderlijke virtuele milieu's verdelen helpen digitale ervaringstoepassingen ontwikkelen en ontwikkelen.

Platform-API's gebruiken

Voor informatie over hoe te om vraag aan Platform APIs met succes te maken, zie de gids op begonnen wordt met Platform APIs.

In de volgende sectie vindt u aanvullende informatie die u moet weten als u verbinding wilt maken met PathFactory via de Flow Service API.

Vereiste referenties verzamelen gather-credentials

Om tot uw rekening PathFactory op het Platform toegang te hebben, moet u de volgende waarden verstrekken:

Credentials

Beschrijving

Gebruikersnaam

Uw PathFactory gebruikersnaam van de account. Dit is essentieel voor het identificeren van uw account in het systeem.

Wachtwoord

Het wachtwoord dat aan uw PathFactory account is gekoppeld. Zorg ervoor dat dit veilig blijft om ongeoorloofde toegang te voorkomen.

Domein

Het domein dat aan uw PathFactory account is gekoppeld. Dit verwijst doorgaans naar de unieke id in de PathFactory URL.

Toegangstoken

Een uniek token dat wordt gebruikt voor API-verificatie om te zorgen voor veilige communicatie tussen uw systemen en PathFactory .

API-eindpunten

Specifieke API-eindpunten voor toegang tot gegevens: Bezoekers, Sessies en Paginaweergaven. Elk eindpunt komt overeen met verschillende gegevenssets die u kunt ophalen. Nota: deze zijn vooraf bepaald door PathFactory en zijn specifiek voor de gegevens u van plan bent toegang te hebben:

Eindpunt van Bezoekers: /api/public/v3/data_lake_apis/visitors.json
Eindpunt van zittingen: /api/public/v3/data_lake_apis/sessions.json
Eindpunt van de Mening van de Pagina: /api/public/v3/data_lake_apis/page_views.json

Voor meer informatie over hoe te om uw geloofsbrieven te beveiligen en te gebruiken, en hoe te om uw toegangstoken te verkrijgen en te verfrissen, bezoek het PathFactory Centrum van de Steun. Deze bron bevat uitgebreide handleidingen voor het beheer van uw referenties en voor een effectieve en veilige API-integratie.

Een basisverbinding maken

Een basisverbinding behoudt informatie tussen uw bron en Platform, met inbegrip van de de authentificatiegeloofsbrieven van uw bron, de huidige staat van de verbinding, en uw unieke identiteitskaart van de basisverbinding. Met de ID van de basisverbinding kunt u bestanden verkennen en door bestanden navigeren vanuit uw bron en kunt u de specifieke items identificeren die u wilt opnemen, inclusief informatie over hun gegevenstypen en indelingen.

Als u een basis-verbindings-id wilt maken, vraagt u een POST naar het /connections -eindpunt en geeft u de PathFactory -verificatiegegevens op als onderdeel van de aanvraaginstantie.

API formaat

POST /connections

Verzoek

Met de volgende aanvraag wordt een basisverbinding voor PathFactory gemaakt:

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"
      }
  }'

Eigenschap

Beschrijving

auth.params.clientId

De client-id die aan uw PathFactory -toepassing is gekoppeld.

auth.params.clientSecret

Het clientgeheim dat aan de toepassing PathFactory is gekoppeld.

connectionSpec.id

The PathFactory connection specification ID: ea1c2a08-b722-11eb-8529-0242ac130003 .

Reactie

Een succesvolle reactie keert de pas gecreëerde verbinding, met inbegrip van zijn unieke verbindings herkenningsteken (id) terug. Deze id is vereist om uw gegevens te kunnen bekijken in de volgende zelfstudie.

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

Volgende stappen

Aan de hand van deze zelfstudie hebt u een PathFactory basisverbinding gemaakt met de Flow Service API. U kunt deze basis verbindings-id in de volgende zelfstudies gebruiken:

recommendation-more-help

337b99bb-92fb-42ae-b6b7-c7042161d089