Création d’une configuration de serveur de destination
La création d’un serveur de destination est la première étape de la création de votre propre destination avec Destination SDK. Le serveur de destination comprend des options de configuration pour les spécifications de serveur et de modèle et pour les options format du message, et formatage de fichier (pour les destinations basées sur des fichiers).
Cette page illustre la requête d’API et la payload que vous pouvez utiliser pour créer votre propre serveur de destination à l’aide du point d’entrée de l’API /authoring/destination-servers
.
Pour obtenir une description détaillée des fonctionnalités configurables avec ce point d’entrée, consultez les articles suivants :
Prise en main des opérations de l’API du serveur de destination get-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.
Création d’une configuration de serveur de destination create
Vous pouvez créer une configuration de serveur de destination en effectuant une requête POST
au point d’entrée /authoring/destination-servers
.
platform.adobe.io/data/core/activation/authoring/destination-servers
Format d’API
POST /authoring/destination-servers
Selon le type de destination que vous créez, vous devez configurer un type de serveur de destination légèrement différent.
Créer des serveurs de destination de schéma statique static-destination-servers
Les onglets ci-dessous proposent des exemples de serveurs de destination pour les destinations qui utilisent des schémas statiques.
Les exemples de payloads ci-dessous incluent tous les paramètres pris en charge par chaque type de serveur de destination. Il n’est pas nécessaire d’inclure tous les paramètres dans votre requête. La payload peut être personnalisée en fonction de vos besoins.
Sélectionnez chaque onglet ci-dessous pour afficher la requête d’API correspondante.
Création d’un serveur de destination en temps réel (streaming)
Vous devez créer un serveur de destination en temps réel (streaming) similaire à celui illustré ci-dessous quand vous configurez une intégration basée sur l’API (streaming) en temps réel.
accordion | ||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Requête | ||||||||||||||||||||||||||||||||
|
accordion |
---|
Réponse |
Une réponse réussie renvoie le statut HTTP 200 avec les détails de la configuration du serveur de destination que vous venez de créer. |
Création d’un serveur de destination Amazon S3
Vous devez créer un serveur de destination Amazon S3 similaire à celui illustré ci-dessous au moment de la configuration d’une destination Amazon S3 basée sur des fichiers.
accordion | |||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Requête | |||||||||||||||||||||||||||||
|
accordion |
---|
Réponse |
Une réponse réussie renvoie le statut HTTP 200 avec les détails de la configuration du serveur de destination que vous venez de créer. |
Création d’un serveur de destination SFTP
Vous devez créer un serveur de destination SFTP similaire à celui illustré ci-dessous au moment de la configuration d’une destination SFTP basée sur des fichiers.
accordion | |||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Requête | |||||||||||||||||||||||||||||||||||
|
accordion |
---|
Réponse |
Une réponse réussie renvoie le statut HTTP 200 avec les détails de la configuration du serveur de destination que vous venez de créer. |
Création d’un serveur de destination Azure Data Lake Storage
Vous devez créer un serveur de destination Azure Data Lake Storage similaire à celui illustré ci-dessous au moment de la configuration d’une destination Azure Data Lake Storage basée sur des fichiers.
accordion | |||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Requête | |||||||||||||||||||||||
|
accordion |
---|
Réponse |
Une réponse réussie renvoie le statut HTTP 200 avec les détails de la configuration du serveur de destination que vous venez de créer. |
Création d’un serveur de destination Azure Blob Storage
Vous devez créer un serveur de destination Azure Blob Storage similaire à celui illustré ci-dessous au moment de la configuration d’une destination Azure Blob Storage basée sur des fichiers.
accordion | |||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Requête | |||||||||||||||||||||||||||||
|
accordion |
---|
Réponse |
Une réponse réussie renvoie le statut HTTP 200 avec les détails de la configuration du serveur de destination que vous venez de créer. |
Création d’un serveur de destination Data Landing Zone (DLZ)
Vous devez créer un serveur de destination Data Landing Zone (DLZ) similaire à celui illustré ci-dessous au moment de la configuration d’une destination Data Landing Zone (DLZ) basée sur des fichiers.
accordion | |||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Requête | |||||||||||||||||||||||
|
accordion |
---|
Réponse |
Une réponse réussie renvoie le statut HTTP 200 avec les détails de la configuration du serveur de destination que vous venez de créer. |
Création d’un serveur de destination Google Cloud Storage
Vous devez créer un serveur de destination Google Cloud Storage similaire à celui illustré ci-dessous au moment de la configuration d’une destination Google Cloud Storage basée sur des fichiers.
accordion | |||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Requête | |||||||||||||||||||||||||||||
|
accordion |
---|
Réponse |
Une réponse réussie renvoie le statut HTTP 200 avec les détails de la configuration du serveur de destination que vous venez de créer. |
Créer des serveurs de destination de schéma dynamique dynamic-schema-servers
Les schémas dynamiques vous permettent de récupérer dynamiquement les attributs cibles pris en charge et de générer des schémas basés sur votre propre API. Vous devez configurer un serveur de destination pour les schémas dynamiques avant de pouvoir configurer le schéma.
Consultez dans l’onglet ci-dessous un exemple de serveur de destination pour les destinations qui utilisent les schémas dynamiques.
L’exemple de payload ci-dessous inclut tous les paramètres requis pour un serveur de schéma dynamique.
Création d’un serveur de schéma dynamique
Vous devez créer un serveur de schéma dynamique similaire à celui illustré ci-dessous quand vous configurez une destination qui récupère son schéma de profil à partir de votre propre point d’entrée de l’API. Contrairement à un schéma statique, un schéma dynamique n’utilise pas de tableau profileFields
, mais un serveur de schéma dynamique qui se connecte à votre propre API à partir de laquelle il récupère la configuration du schéma.
accordion | |||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Requête | |||||||||||||||||||||||||||||
|
accordion |
---|
Réponse |
Une réponse réussie renvoie le statut HTTP 200 avec les détails de la configuration du serveur de destination que vous venez de créer. |
Création de serveurs de destination de liste déroulante dynamiques dynamic-dropdown-servers
Utilisez des listes déroulantes dynamiques pour récupérer et remplir de manière dynamique les champs de données client de liste déroulante, en fonction de votre propre API. Vous pouvez, par exemple, récupérer une liste des comptes d’utilisateurs existants que vous souhaitez utiliser pour une connexion de destination.
Vous devez configurer un serveur de destination pour les listes déroulantes dynamiques avant de pouvoir configurer le champ de données client de liste déroulante dynamique.
Voir dans l’onglet ci-dessous un exemple de serveur de destination utilisé pour récupérer dynamiquement les valeurs à afficher dans un sélecteur de liste déroulante, à partir d’une API.
L’exemple de payload ci-dessous inclut tous les paramètres requis pour un serveur de schéma dynamique.
Créez un serveur de liste déroulante dynamique
Vous devez créer un serveur de liste déroulante dynamique similaire à celui illustré ci-dessous lorsque vous configurez une destination qui récupère les valeurs d’un champ de données client de liste déroulante de votre propre point de terminaison API.
accordion | ||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Requête | ||||||||||||||||||||||||||||||||
|
accordion |
---|
Réponse |
Une réponse réussie renvoie le statut HTTP 200 avec les détails de la configuration du serveur de destination que vous venez de créer. |
Gestion des erreurs d’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 créer un serveur de destination avec le point d’entrée /authoring/destination-servers
Destination SDK de l’API.
Pour en savoir plus sur les fonctionnalités offertes par ce point d’entrée, consultez les articles suivants :
Pour comprendre la place de ce point d’entrée dans le processus de création de destinations, consultez les articles suivants :