Aan de slag met de Policy Service API
Met de API van Policy Service kunt u verschillende bronnen maken en beheren die te maken hebben met Adobe Experience Platform-gegevensbeheer. Dit document bevat een inleiding op de kernconcepten die u moet kennen voordat u de API van Policy Service aanroept.
Vereisten
Het gebruik van de ontwikkelaarshandleiding vereist een goed begrip van de verschillende Experience Platform -services die betrokken zijn bij het werken met mogelijkheden voor gegevensbeheer. Voordat u met de Policy Service API begint te werken, raadpleegt u de documentatie voor de volgende services:
- Beheer van Gegevens: Het kader waardoor Experience Platform naleving van het gegevensgebruik afdwingt.
- Experience Data Model (XDM) System: Het gestandaardiseerde framework waarmee Experience Platform gegevens voor de klantervaring indeelt.
- Real-Time Customer Profile: biedt een uniform, real-time consumentenprofiel dat is gebaseerd op geaggregeerde gegevens van meerdere bronnen.
- Sandboxen: Experience Platform verstrekt virtuele zandbakken die één enkele Platform instantie in afzonderlijke virtuele milieu's verdelen helpen digitale ervaringstoepassingen ontwikkelen en ontwikkelen.
API-voorbeeldaanroepen lezen
De API-documentatie van Policy Service biedt voorbeeld-API-aanroepen om aan te tonen hoe uw aanvragen moeten worden opgemaakt. Dit zijn paden, vereiste kopteksten en correct opgemaakte ladingen voor aanvragen. Voorbeeld-JSON die wordt geretourneerd in API-reacties, wordt ook verschaft. Voor informatie over de overeenkomsten die in documentatie voor steekproef API vraag worden gebruikt, zie de sectie op hoe te om voorbeeld API vraagin de Experience Platform het oplossen van problemengids te lezen.
Vereiste koppen
De API documentatie vereist u ook om het authentificatieleerprogrammate voltooien om vraag aan Platform eindpunten met succes te maken. Als u de zelfstudie over verificatie voltooit, krijgt u de waarden voor elk van de vereiste headers in API-aanroepen van Experience Platform , zoals hieronder wordt getoond:
Authorization: Bearer {ACCESS_TOKEN}
x-api-key: {API_KEY}
x-gw-ims-org-id: {ORG_ID}
Alle bronnen in Experience Platform, inclusief bronnen die tot gegevensbeheer behoren, zijn geïsoleerd naar specifieke virtuele sandboxen. Alle aanvragen naar Platform API's vereisen een header die de naam van de sandbox opgeeft waarin de bewerking plaatsvindt:
x-sandbox-name: {SANDBOX_NAME}
Alle verzoeken die een nuttige lading (POST, PUT, PATCH) bevatten vereisen een extra kopbal:
Content-Type: application/json
Core vs aangepaste bronnen
Binnen de API van Policy Service worden alle beleidsregels en marketingacties core
of custom
bronnen genoemd.
core
-bronnen zijn de bronnen die door Adobe worden gedefinieerd en onderhouden, terwijl custom
-bronnen de bronnen zijn die door uw organisatie worden gemaakt en onderhouden en daarom uniek en alleen zichtbaar zijn voor uw organisatie. Het weergeven van lijsten en opzoekbewerkingen (GET
) zijn daarom de enige bewerkingen die zijn toegestaan in core
-bronnen, terwijl het weergeven, opzoeken en bijwerken van bewerkingen (POST
, PUT
, PATCH
en DELETE
) beschikbaar is voor custom
-bronnen.
Volgende stappen
Beginnen makend vraag gebruikend de Dienst API van het Beleid, selecteer één van de beschikbare eindpuntgidsen.