
Comparatif documenté · 4 périmètres
Import complet, synchronisation incrémentale ou notification ?
Ces mécanismes ne fournissent pas la même preuve d’exhaustivité. Définissez ce qu’un lot absent, un curseur perdu ou un événement répété signifie pour votre base.
Contenu éditorial mis à jour le . Chaque référence indique sa propre date de consultation. Les faits sont attribués aux sources ; les scénarios et conseils sont éditoriaux. Le périmètre commercial, les prix et les droits de votre compte restent à confirmer.
Références documentaires et points à vérifier
Les lignes comparent des rôles et des conditions d’accès. Un point non documenté reste une question à poser, sans lui attribuer une note négative. Sur téléphone, chaque périmètre se lit dans une carte.
| Périmètre et rôle | Documenté | Limite | À demander |
|---|---|---|---|
Synchronisation complète Construire ou reconstruire un état sur un périmètre défini | Le guide Google Calendar décrit une synchronisation initiale complète avant l’utilisation de son mécanisme incrémental. Google Calendar : synchroniser les ressources ↗Consulté le | Ce fonctionnement est propre à l’API décrite. Un fichier appelé complet doit encore avoir un périmètre confirmé. | Quelles pages et quels objets établissent que le lot reçu couvre le périmètre attendu ? |
Synchronisation incrémentale Lire les changements selon le mécanisme de l’API | Google Calendar utilise un jeton de synchronisation et décrit une reconstruction complète lorsqu’il devient invalide, signalée par une réponse 410. Google Calendar : suivi incrémental et invalidation ↗Consulté le | Le jeton et cette réponse ne constituent pas une règle universelle de toutes les API. | Quelle procédure documentée traite une interruption ou l’invalidation du curseur ? |
Notification d’événement Signaler un changement pour déclencher un traitement | Stripe documente des livraisons répétées et un ordre de livraison non garanti pour ses événements. Stripe : garanties et traitement des événements ↗Consulté le | Une notification ne remplace pas automatiquement un rapprochement exhaustif ou la lecture de l’état actuel. | Comment retrouver un changement manqué et éviter une action répétée ? |
Notifications OCTO Signaler des changements sur les objets couverts | OCTO décrit une capacité optionnelle de notifications portant sur des changements de produits, de disponibilités et de réservations. OCTO : notifications optionnelles ↗Consulté le | Une capacité optionnelle doit être réellement proposée et activée par le fournisseur concerné. | Quels événements et mécanismes de reprise sont confirmés pour cette intégration ? |
Définir ce que l’absence signifie
Une ligne absente d’un différentiel n’indique pas forcément un retrait. Une absence dans un lot complet peut avoir un sens seulement si la couverture et les règles de suppression sont documentées. Conservez le type du lot avec les résultats d’application.
Documentez aussi les objets exclus : langue, zone, statut ou marché. Le rapprochement ne doit pas supprimer une fiche simplement parce qu’elle sort du filtre courant.
Préparer la reprise avant l’interruption
Gardez le point de reprise selon les garanties du service et n’avancez pas le suivi avant l’application durable des changements. Testez l’arrêt entre deux pages et le rejeu du dernier lot. La base doit conserver des identités stables.
Pour OCTO, examinez la capacité optionnelle et les événements réellement disponibles chez le fournisseur. Un objet normalisé ne prouve pas que tous les mécanismes optionnels sont proposés. Gardez les différences visibles dans le contrat de traitement et dans les tests.
Combiner les mécanismes avec un rôle explicite
Un projet peut utiliser des notifications pour réagir et une synchronisation pour rapprocher l’état. Cette combinaison demande une règle lorsqu’une lecture et un événement se croisent. La chronologie d’arrivée ne doit pas suffire à faire régresser un dossier.
Choisissez une fréquence de rapprochement selon l’usage, les limites du service et l’impact d’une donnée ancienne. La comparaison ne prescrit pas un délai universel et ne prouve pas la disponibilité de fonctions sur votre compte.
Rattraper les changements pendant une coupure de synchronisation
Scénario de préparation : des notifications manquent pendant la bascule alors qu’un import complet est possible. Définissez le point de reprise, le traitement des suppressions et la règle de résolution de conflit. Les mécanismes disponibles dépendent du fournisseur.
La preuve attendue rapproche un état final, des identités stables et la fenêtre couverte. Gardez les éléments non retrouvés en réserve ; un nombre de lignes identique ne prouve pas que les mêmes offres et conditions sont présentes.
Choisir selon le besoin
Trois situations pour cadrer le bon périmètre
Le choix dépend du volume, de la fréquence de changement et des garanties du flux. Avant d’estimer la vitesse, définissez comment un consommateur obtient un état initial, découvre une suppression et retrouve les changements manqués. Une notification peut déclencher une lecture sans contenir tout l’objet.
Les situations ci-dessous sont fictives. Elles servent à comparer un périmètre de travail et les preuves nécessaires ; elles ne décrivent pas les conditions d’une offre fournisseur.
Première constitution de catalogue
Cas fictif : le périmètre annoncé comprend 240 objets et le service du cas répond par pages de 80. La dernière page et le signal de fin doivent être contrôlés avant de retenir l’état initial.
Avant de retenir ce périmètre : Rapprocher les 240 identifiants uniques sur trois pages, le périmètre et les éventuels objets exclus. Ce découpage appartient au scénario ; il ne définit pas la pagination de toutes les API.
Catalogue changeant à grand volume
Cas fictif : après l’état initial, le delta fourni comprend douze mises à jour et trois suppressions. Le contrat de test décrit le curseur et la reprise après interruption.
Avant de retenir ce périmètre : Vérifier les douze valeurs modifiées, les trois objets retirés ou désactivés et le nouveau point de reprise. Le seul nombre de messages reçus ne démontre pas la cohérence du catalogue final.
Réaction rapide à un événement
Cas fictif : une notification signale la modification du produit P8 et fournit sa référence, sans les nouveaux champs. Le consommateur peut lire le produit avec l’opération prévue dans le cas.
Avant de retenir ce périmètre : Comparer délai de réaction et capacité de rapprochement. Lire l’état pertinent avant application ; traiter aussi l’événement manqué ou répété selon les garanties du fournisseur, sans supposer une livraison exhaustive.
Arbitrer les contraintes et le coût de fonctionnement
Les approches peuvent être combinées : import initial, changements incrémentaux et revue de cohérence. Cette combinaison doit avoir des responsabilités claires pour éviter deux traitements contradictoires. Le coût se mesure avec objets relus, reprises et écarts à résoudre, pas seulement le nombre de requêtes quotidiennes. Sur un catalogue fictif de 105 objets répartis en pages de 50, la dernière page contient cinq objets. Une reprise après la deuxième page ne doit ni perdre ces cinq références ni republier les cent premières comme de nouveaux produits. Comparez aussi les identifiants : retrouver 105 lignes ne suffit pas si un objet manque et qu’un autre est présent deux fois. Le coût de la connexion inclut le diagnostic des suppressions, des événements répétés et des interruptions.
Points à clarifier avant la décision
- La fin du lot ou le point de reprise n’est pas identifiable, empêchant de vérifier la couverture de l’état conservé.
- Un objet supprimé ou un changement manqué ne peut pas être retrouvé par le mécanisme de rapprochement prévu.
Quatre cas pour rendre la comparaison vérifiable
Les nombres et situations ci-dessous sont fictifs, à adapter au périmètre proposé. Utilisez un environnement et des données de test autorisés. Conservez les réponses, les opérations manuelles et les points qui restent inconnus.
| Situation | Contrôle | Preuve utile |
|---|---|---|
| Trois pages et un événement répété | Cas fictif : 105 objets, pages de 50, puis deux notifications portant sur le même objet. Simuler la reprise après la page 2. | Les 105 identifiants sont retrouvés sans doublon ; le point de reprise et le traitement répété sont justifiables. |
| Curseur invalide | Appliquer la procédure du fournisseur concerné. | Réponse observée, reconstruction et rapprochement final. |
| Suppression pendant une interruption | Supprimer un objet source pendant la coupure du flux. Relancer notification puis rapprochement complet. | Objet retiré ou désactivé selon la règle attendue, sans le recréer depuis un cache plus ancien. |
| Lecture et événement croisés | Conserver l’état de référence approprié. | Versions des objets, ordre de traitement et résultat. |
Consulter le registre de comparaison et préparer le contrôle d’accès API.
Questions fréquentes
Une notification remplace-t-elle l’import ?
Pas nécessairement. Vérifiez si elle couvre les objets, permet la reprise et fournit l’état nécessaire à votre usage.
Peut-on supprimer les lignes absentes ?
Seulement selon un périmètre et une règle documentés. Un lot partiel ou filtré ne suffit pas à conclure à un retrait.
Toutes les API renvoient-elles 410 pour un curseur expiré ?
Non. Cette procédure est décrite pour Google Calendar ; chaque fournisseur possède ses garanties et erreurs propres.
Un flux de notifications peut-il remplacer tout import ?
Un flux de notifications peut accélérer la réaction, mais il faut encore pouvoir constituer et vérifier l’état utile après une interruption. Demandez ce que contient l’événement et comment retrouver l’objet courant. Les jetons, suppressions et procédures de reconstruction dépendent de l’API ; un mécanisme documenté chez un fournisseur ne vaut pas règle universelle.
Documentation et application
Les précisions utiles des sources
Mews : fenêtres de synchronisation et références de canal
La version d’opération 2023-06-06 sépare les identifiants de réservation des références reçues d’un canal OTA, GDS ou CRS.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| ReservationIds | Le filtre accepte au maximum 1 000 identifiants de réservation. | Fractionner une reprise de références sans tronquer silencieusement la liste. |
| ChannelNumbers | Les références de canal ont leur propre filtre, limité à 100 éléments. | Conserver le type de référence ; une chaîne OTA n’est pas automatiquement l’Id Mews. |
| CreatedUtc et UpdatedUtc | Les intervalles de ces filtres sont limités à trois mois. | Découper un historique plus long et suivre les bornes réellement traitées. |
| Accès | Les réservations retournées sont limitées au périmètre de l’AccessToken. | Un résultat vide ne démontre pas l’absence de réservation dans les établissements hors périmètre. |
| Version de l’opération | ChannelNumbers accepte 1 000 éléments dans la version 2017-04-12, contre 100 dans la version 2023-06-06. | Conserver le chemin versionné avec la limite avant de construire les lots. |
Limites propres à cette opération documentée ; elles ne décrivent pas toutes les API Mews ni les droits d’un contrat particulier.
Mews Connector API — reservations/getAll/2023-06-06 · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.
Examiner le dossier et son périmètre.
Postmark : un code d’erreur peut arrêter les notifications
La réponse du point de réception détermine si Postmark retentera de transmettre un événement sortant.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| Nouvelle tentative | Les erreurs 5xx, 408, 429 et les échecs réseau donnent lieu à des reprises. | Conserver l’événement et surveiller la récupération du service. |
| Arrêt de l’événement | Les autres erreurs 4xx, dont 401, 403, 404 et 422, ne sont pas retentées. | Ne pas compter sur une nouvelle tentative automatique après une erreur d’authentification ou une URL incorrecte. |
| Accusé de réception | Postmark demande une réponse 200 après traitement ou remise à une file durable. | Distinguer réception technique, sauvegarde durable et traitement métier. |
| Vérification | Une défaillance persistante peut suspendre un type d’événement jusqu’à correction et nouvelle vérification. | Contrôler les statuts Delivery et Bounce séparément ; une catégorie qui fonctionne ne prouve pas que l’autre fonctionne. |
| Authentification | Postmark ne fournit pas de signature HMAC ; sa documentation recommande HTTP Basic Authentication en HTTPS et un filtrage des adresses IP. | Contrôler le mécanisme du fournisseur, puis la structure du message, au lieu d’attendre un en-tête de signature inexistant. |
Comportement des webhooks sortants Postmark ; les messages entrants utilisent une infrastructure distincte.
Postmark — Webhooks overview, retry attempts · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.
Compléter la décision avec les guides et les catégories
- Pagination et synchronisation : importer un catalogue sans perdre des fiches
- Webhooks de réservation : éviter doublons et états incohérents
- Cache et look-to-book : réduire les appels sans figer les prix
- Observabilité des API de réservation voyage : mesurer et réagir
- Data et intelligence marché
- Logiciels et création web