Een PathFactory basisverbinding maken met de Flow Service API
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 .
Aan de slag
Deze handleiding vereist een goed begrip van de volgende onderdelen van 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 Experience Platform.
- Sandboxes : Experience Platform verstrekt virtuele zandbakken die één enkele instantie van Experience Platform in afzonderlijke virtuele milieu's verdelen helpen digitale ervaringstoepassingen ontwikkelen en ontwikkelen.
Experience Platform API's gebruiken
Voor informatie over hoe te om vraag aan Experience Platform APIs met succes te maken, zie de gids op begonnen wordt met Experience 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
U moet de volgende waarden opgeven om toegang te krijgen tot uw PathFactory-account op de Experience Platform:
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 Experience Platform, met inbegrip van de verificatiereferenties van uw bron, de huidige status 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-aanvraag naar het /connections -eindpunt en geeft u de PathFactory -verificatiegegevens op als onderdeel van de aanvraagprocedure.
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"
}
}'
auth.params.clientIdauth.params.clientSecretconnectionSpec.idea1c2a08-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: