Utiliser le paramètre

Ajoute updated_within_days comme paramètre de requête à ta demande :

GET /v1/contacts?updated_within_days=7

Cela renvoie uniquement les contacts dont les données ont été modifiées au cours des 7 derniers jours. La fenêtre est glissante à partir du moment de la demande, donc 1 équivaut aux dernières 24 heures.

Les valeurs valides sont des entiers de 1 à 365 inclus. Si tu omets le paramètre, l'endpoint fonctionne exactement comme avant et renvoie tous les contacts.

La description complète du paramètre se trouve dans la spécification OpenAPI via GET /v1/openapi.json.

Fiabilité de `updated_at`

À partir de cette version, le timestamp updated_at d'un contact n'est mis à jour que lorsque quelque chose change réellement dans les données du contact. Auparavant, ce champ était également modifié lors de l'importation nocturne, même si rien n'avait changé.

Attention : le timestamp n'est pas encore totalement fiable dans toutes les situations. Les désinscriptions et les modifications d'appartenance aux listes ne sont actuellement pas encore prises en compte dans updated_at. Les contacts qui ont uniquement été désinscrits ou ajoutés à une liste peuvent donc ne pas apparaître dans tes résultats lorsque tu filtres sur updated_within_days.

Questions fréquentes

Les valeurs comme 0 ou supérieures à 365 sont en dehors de la plage valide. Consulte la spécification OpenAPI (GET /v1/openapi.json) pour connaître la réponse d'erreur exacte que l'API renvoie dans ce cas.

Si un contact a uniquement été désinscrit et n'a pas été modifié autrement, updated_at n'est pas encore mis à jour pour cela. Ce contact n'apparaîtra alors pas dans les résultats de updated_within_days, même si une modification pertinente a eu lieu. Cela s'applique également aux modifications d'appartenance aux listes.

Le paramètre est documenté dans la spécification OpenAPI de Xendy. Tu y accèdes via GET /v1/openapi.json.

Joeri Ras

Rédigé par

Joeri Ras

Fondateur & copropriétaire @ Xendy

Tu préfères un contact direct ?

Articles associés

Intégrations

Connecter Gravity Forms à Xendy

Avec Gravity Forms, tu crées facilement des formulaires dans WordPress. Grâce à la connexion avec Xendy, les soumissions arrivent automatiquement dans un segment statique, ce qui te permet d'utiliser tes nouveaux contacts directement pour des newsletters ou des automatisations d'e-mails.

Lire la suite
Intégrations

Connecter ta boutique Lightspeed à Xendy

En connectant Lightspeed à Xendy, les données clients, commandes et produits sont automatiquement synchronisées chaque nuit. Tu peux ainsi créer des segments basés sur le comportement d'achat et afficher des produits directement dans tes e-mails.

Lire la suite
Intégrations

Connecter ta boutique Magento 2 à Xendy

En connectant Magento 2 à Xendy, les données clients, commandes et produits sont automatiquement synchronisées chaque nuit. Tu peux ainsi créer des segments basés sur le comportement d'achat, afficher des recommandations de produits personnalisées et effectuer un suivi des paniers abandonnés. Attention : les paniers abandonnés ne fonctionnent avec Magento 2 que pour les clients connectés à ta boutique en ligne.

Lire la suite
Intégrations

Connecter ta boutique Shopify à Xendy

En connectant Shopify à Xendy, les données clients, commandes et produits sont automatiquement mises à jour chaque nuit. Tu peux ainsi créer des segments basés sur le comportement d'achat et intégrer des recommandations de produits personnalisées dans tes e-mails. Les paniers abandonnés passent par l'application Xendy dans Shopify : toute personne qui abandonne le processus de paiement reçoit automatiquement l'e-mail de rappel. Si tu souhaites utiliser cette fonctionnalité, contacte le support.

Lire la suite