Exports - Générer et intégrer

Lorsque vous exporter régulièrement les données de la plateforme pour alimenter un projet numérique, il est impératif de confirmer à Apidae que le fichier de données a bien été récupéré.

Attention, si ce paramétrage n'est pas fait et que nous constatons trop d'exports non confirmés, cela peut être interprété comme une absence d'utilisation et mener à une désactivation de vos exports.

Il est donc nécessaire que votre prestataire technique configure les projets pour renvoyer vers la plateforme Apidae une confirmation notifiant que le fichier d'export a bien été récupéré. Voici les éléments à lui transmettre pour réaliser ce paramétrage.

Confirmation de l'export

Pour des exports réguliers, vous devez définir une URL de web service qui sera contactée à l'issue de l'export en lui fournissant un lien vers le fichier d'export.
Cette URL se paramètre dans Apidae dans la fiche du projet --> onglet Configuration technique --> Champ "Url de notification".
La description des paramètres transmis à cette URL est disponible ici :
http://dev.apidae-tourisme.com/fr/documentation-technique/v2/exports/notificationi-traitement-confirmation

Parmi ces paramètres vous trouverez le paramètre "urlRecuperation", alimenté avec le lien vers le fichier.

En retour de cet appel, vous verrez que vous devez contacter l'url renseignée dans le paramètre "urlConfirmation" qui nous permet d'acter que vous avez bien récupéré le fichier.

A noter : il n'est pas possible d'effectuer la confirmation d'intégration dans le script qui répond à la notification. La confirmation doit être réalisée après avoir répondu à la notification (voir doc développeurs : http://dev.apidae-tourisme.com/fr/documentation-technique/v2/exports/notificationi-traitement-confirmation).

Dès lors que l'export est confirmé, il apparaît dans la liste des tâches d'export (interfaces du membre et dev-tools) de l'application avec un fond vert sous le statut « Généré et intégré » (au lieu de « Généré »).

Si cette action n'est pas effectuée, vous prenez le risque que ces exports soient considérés comme inexploités et votre projet peut se voir être désactivé.

Le fichier reste également temporairement disponible via l'application (fiche projet --> onglet Calcul des sélections et Exports)