Validation des champs client générés par le modèle
Vue d’ensemble overview
Le point d’entrée /authoring/testing/template/render vous permet de visualiser à quoi les champs de données client modélisés définis dans votre configuration de destination ressembleraient.
Le point d’entrée génère des valeurs aléatoires pour vos champs de données client et les renvoie dans la réponse. Cela vous permet de valider la structure sémantique des champs de données client, tels que les noms de compartiment ou les chemins d’accès au dossier.
Prise en main getting-started
Avant de poursuivre, consultez le guide de prise en main pour obtenir des informations importantes à connaître avant d’effectuer des appels vers l’API, notamment sur la manière d’obtenir l’autorisation de création de la destination et les en-têtes obligatoires.
Conditions préalables prerequisites
Avant d’utiliser le point d’entrée /template/render, veillez à respecter les conditions suivantes :
-
Une destination existante basée sur des fichiers a été créée avec Destination SDK et vous pouvez la voir dans votre catalogue de destination.
-
Pour réussir la requête API, vous avez besoin de l’identifiant d’instance de destination correspondant à l’instance de destination que vous allez tester. Obtenez l’identifiant d’instance de destination que vous devez utiliser dans l’appel API, à partir de l’URL, pendant l’exploration d’une connexion avec la destination dans l’interface utilisateur de Platform.
Rendu des champs clients modélisés render-customer-fields
Format d’API
POST /authoring/testing/template/render/destination
Pour illustrer le comportement de ce point d’entrée de l’API, prenons une destination basée sur un fichier avec la configuration des champs de données client suivante :
"fileBasedS3Destination":{
"bucket":{
"templatingStrategy":"PEBBLE_V1",
"value":"{{customerData.bucket}}"
},
"path":{
"templatingStrategy":"PEBBLE_V1",
"value":"{{customerData.path}}"
}
}
Requête
La requête ci-dessous appelle le point d’entrée /authoring/testing/template/render, qui renvoie une réponse avec des valeurs générées de manière aléatoire pour les deux champs de données client mentionnés ci-dessus.
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}}"
}
}'
destinationIdtemplatesRéponse
Une réponse réussie renvoie un statut HTTP 200 OK et le corps comprend des valeurs générées de manière aléatoire pour vos champs modélisés.
Cette réponse peut vous aider à valider la structure sémantique des champs de vos données client, tels que les noms de compartiment ou les chemins d’accès au dossier.
{
"results": {
"bucket": "hfWpE-bucket",
"path": "hfWpE-bucket/ceC"
}
}
Gestion des erreurs d’API api-error-handling
Les points d’entrée de l’API Destination SDK suivent les principes généraux des messages d’erreur de l’API Experience Platform. Consultez les sections Codes dʼétat d’API et Erreurs dʼen-tête de requête dans le guide de dépannage de Platform.
Étapes suivantes next-steps
Vous êtes arrivé au bout de ce document. À présent, vous savez comment valider la configuration des champs de données client définie dans votre serveur de destination.