Gevalideerde klantvelden valideren
Overzicht overview
Het /authoring/testing/template/render
eindpunt helpt u visualiseren hoe de templatized gebieden van klantengegevensdie in uw bestemmingsconfiguratie worden bepaald als zouden kijken.
Het eindpunt produceert willekeurige waarden voor uw gebieden van klantengegevens, en keert hen in de reactie terug. Hierdoor kunt u de semantische structuur van gegevensvelden van klanten, zoals emmernamen of mappaden, valideren.
Aan de slag getting-started
Alvorens verder te gaan, te herzien gelieve begonnen gidsvoor belangrijke informatie die u moet kennen om vraag aan API met succes te maken, met inbegrip van hoe te om de vereiste toestemming van de bestemmings authoring en vereiste kopballen te verkrijgen.
Vereisten prerequisites
Voordat u het eindpunt /template/render
kunt gebruiken, moet u controleren of aan de volgende voorwaarden is voldaan:
-
U hebt een bestaande op dossier-gebaseerde bestemming die door de Destination SDK wordt gecreeerd en u kunt het in uw catalogus van bestemmingenzien.
-
Als u de API-aanvraag met succes wilt uitvoeren, hebt u de id van de doelinstantie nodig die overeenkomt met de doelinstantie die u wilt testen. Krijg bestemmingsidentiteitskaart die u in de API vraag, van URL zou moeten gebruiken, wanneer het doorbladeren van een verbinding met uw bestemming in Platform UI.
Gelimiteerde klantvelden renderen render-customer-fields
API formaat
POST /authoring/testing/template/render/destination
Om het gedrag van dit API eindpunt te illustreren, overwegen een op dossier-gebaseerde bestemming met de volgende configuratie van de gebieden van klantengegevens:
"fileBasedS3Destination":{
"bucket":{
"templatingStrategy":"PEBBLE_V1",
"value":"{{customerData.bucket}}"
},
"path":{
"templatingStrategy":"PEBBLE_V1",
"value":"{{customerData.path}}"
}
}
Verzoek
Het verzoek hieronder roept het /authoring/testing/template/render
eindpunt, dat een reactie met willekeurig geproduceerde waarden voor de twee hierboven vermelde gebieden van klantengegevens terugkeert.
curl -X POST 'https://platform.adobe.io/data/core/activation/authoring/testing/template/render/destination' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'Content-Type: application/json' \
-H 'x-gw-ims-org-id: {IMS_ORG}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-d '
{
"destinationId": "{DESTINATION_CONFIGURATION_ID}",
"templates": {
"bucket": "{{customerData.bucket}}",
"path": "{{customerData.bucket}}/{{customerData.path}}"
}
}'
destinationId
templates
Reactie
Een geslaagde reactie retourneert een HTTP 200 OK
-status en de hoofdtekst bevat willekeurig gegenereerde waarden voor uw sjabloonvelden.
Deze reactie kan u helpen de correcte structuur van uw gebieden van klantengegevens, zoals emmernamen of omslagwegen bevestigen.
{
"results": {
"bucket": "hfWpE-bucket",
"path": "hfWpE-bucket/ceC"
}
}
API-foutafhandeling api-error-handling
Destination SDK API-eindpunten volgen de algemene API-foutberichtbeginselen voor Experience Platforms. Verwijs naar API statuscodesen de fouten van de verzoekkopbalin de het oplossen van problemengids van het Platform.
Volgende stappen next-steps
Na het lezen van dit document, weet u nu hoe te om de configuratie te bevestigen van het gebied van klantengegevens die in uw bestemmingsserverwordt bepaald.