Développeur ou développeuse d’intégrations

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.

• 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.

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 31/10/2026. Les contrôles proposés sont une lecture éditoriale de cette référence.

Examiner le dossier et son périmètre.

Demand API 3.2 : migrer les champs de prix et les filtres

Le guide de migration 3.2 décrit des changements de structure. Une réponse qui reste un JSON valide peut donc nécessiter un nouveau mapping de champs.

• Prix affiché : Le guide demande price.display à la place de price.book. Identifier la version de la réponse avant d’interpréter le champ manquant comme un prix absent.
• Charges : price.charges remplace extra_charges dans la structure décrite ; les indicateurs included_in.display et chargeable_online distinguent affichage et encaissement. Ne pas déduire le lieu de paiement du seul classement d’une charge dans le prix affiché.

Cette correspondance est attachée au guide de migration 3.2. Elle ne doit pas être transposée sans vérification à une autre version ou à tous les endpoints Orders.

Booking.com — migration 3.2, recherche d’hébergements · consultée le 22/10/2026. Les contrôles proposés sont une lecture éditoriale de cette référence.

Examiner le dossier et son périmètre.

Places API New : demander les champs au bon niveau

Place Details, Nearby Search et Text Search exigent une liste de champs à retourner. Aucune liste par défaut ne remplace le masque manquant.

• Masque requis : L’absence de masque de réponse provoque une erreur pour ces méthodes. Conserver le masque avec la requête et les critères de recette.
• Chemin du champ : Nearby et Text Search renvoient une liste sous places ; Place Details renvoie directement un objet Place. Comparer places.formattedAddress à formattedAddress selon la méthode appelée.

La sélection de champs ne donne pas un droit de conservation générale des contenus. Les règles de stockage, d’attribution et les conditions régionales restent distinctes.

Google Places API New — Choose fields to return · consultée le 22/10/2026. Les contrôles proposés sont une lecture éditoriale de cette référence.

Examiner le dossier et son périmètre.

Hotelbeds : relire un tarif sans mélanger les opérations

Les bonnes pratiques précisent quand recontrôler le tarif et comment conserver sa référence.

• Référence opaque : rateKey doit être recopié entre opérations, sans interprétation de sa structure interne. Ne pas extraire dates ou occupation en découpant cette chaîne.
• Recontrôle ciblé : CheckRates est requis pour RECHECK ; pour BOOKABLE, il peut être utilisé pour une information complémentaire telle que RateComments. Ne pas recontrôler systématiquement chaque résultat de recherche.

Bonnes pratiques Hotel Booking API consultées le 31 octobre 2026. Les scénarios sont des lectures éditoriales, sans appel fournisseur. Un recontrôle terminé ne constitue pas une confirmation de réservation et le délai de 60 secondes n’est pas une promesse de réponse au client.

Hotelbeds — Hotel Booking API, Best practices · consultée le 31/10/2026. Les contrôles proposés sont une lecture éditoriale de cette référence.

Examiner le dossier et son périmètre.

Viator Supplier API : séparer places restantes et heure limite

Le système de réservation transmet plusieurs informations complémentaires pour décider si une option peut encore être vendue.

• Date limite : BookingCutoff contient exactement un choix : DateTime avec fuseau, ProductDateTime en heure locale du produit ou NotApplicable=true. Conserver la convention horaire avant toute comparaison.
• Places : Capacity.Simple.Remaining décrit les places encore disponibles pour Viator. Ne pas l’assimiler à la capacité totale du site ou de l’opérateur.

Modèle Supplier API, distinct du contrat Partner API. Une place restante ne supprime pas une heure limite de réservation.

Viator Reservation System API — BookingCutoff and Capacity · consultée le 22/10/2026. Les contrôles proposés sont une lecture éditoriale de cette référence.

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.

• 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.

Comportement des webhooks sortants Postmark ; les messages entrants utilisent une infrastructure distincte.

Postmark — Webhooks overview, retry attempts · consultée le 22/10/2026. Les contrôles proposés sont une lecture éditoriale de cette référence.

OCTO Pricing : distinguer prix par unité et prix par réservation

Le nombre de participants ne suffit pas à calculer le prix d’une activité privée. Le mode de tarification se lit avant la multiplication.

• Unité ou réservation : pricingPer vaut UNIT ou BOOKING. En mode BOOKING, le prix s’applique une fois à la réservation plutôt qu’à chaque unité achetée. Ne pas multiplier un prix de privatisation par le nombre de participants.
• Prix indicatif : Le suffixe From, comme pricingFrom, indique un prix indicatif et non final. Conserver cette nuance dans le calendrier et vérifier le prix de la sélection.

Capacité optionnelle pricing, à demander dans Octo-Capabilities. Le standard ne prouve pas son activation chez chaque fournisseur.

OCTO — Pricing capability · consultée le 22/10/2026. Les contrôles proposés sont une lecture éditoriale de cette référence.

Examiner le dossier et son périmètre.

GetYourGuide Supplier : une modification peut conserver la référence GYG

Une demande de changement d’effectif ou d’horaire crée un nouveau cycle de réservation dans le parcours documenté.

• Même référence GYG : GetYourGuide crée une nouvelle réserve puis une réservation avec la même référence GYG, mais des données modifiées. Ne pas ignorer la demande comme un doublon uniquement parce que la référence GYG est déjà connue.
• Nouveau résultat : L’intégrateur doit détecter les données modifiées et retourner une nouvelle réservation. Conserver la référence fournisseur et les détails de chaque version.

Parcours Supplier API lorsque le client demande une modification à GetYourGuide ; distinct des droits de l’API partenaire de distribution.

GetYourGuide Integrator Portal — Booking Change · consultée le 22/10/2026. Les contrôles proposés sont une lecture éditoriale de cette référence.

Examiner le dossier et son périmètre.

Mapbox v6 : distinguer précision du point, correspondance et accès

Un point placé sur le bon bâtiment ne décrit pas nécessairement l’endroit où un véhicule doit s’arrêter ou le groupe se présenter.

• Précision géographique : coordinates.accuracy distingue notamment rooftop, parcel, point et interpolated. interpolated estime position et existence à partir d’adresses voisines. Un résultat interpolé demande une confirmation du point de rendez-vous ; ne le présentez pas comme une entrée observée.
• Correspondance de l’adresse : match_code détaille les composants de la requête. La confiance exact peut encore comporter jusqu’à deux composants déduits. Relisez les composants, pas seulement le score global : exact n’atteste pas que chaque élément a été fourni et confirmé.

Ces champs documentent une réponse de géocodage, sans garantir accessibilité, autorisation de stationnement ou disponibilité d’un transfert.

Mapbox — Geocoding v6, précision et Smart Address Match · consultée le 22/10/2026. Les contrôles proposés sont une lecture éditoriale de cette référence.

Unicode : même nom visible, suites de caractères différentes

Un accent peut être composé dans un caractère ou ajouté après la lettre. Deux libellés visuellement identiques peuvent donc échouer à une comparaison brute.

• NFC et NFD : NFD décompose les équivalences canoniques ; NFC les décompose puis les recompose lorsque c’est possible. Exemple pédagogique : Café avec U+00E9 et Cafe suivi de U+0301 deviennent identiques en NFC.
• NFKC et NFKD : Ces formes appliquent aussi les équivalences de compatibilité : le chiffre romain Ⅳ devient IV. Une clé de recherche peut perdre une distinction conservée dans le libellé. Choisissez la transformation par usage.

La normalisation ne traduit pas, ne corrige pas un mauvais décodage et ne supprime pas automatiquement les accents. Elle ne remplace pas les règles d’identité du catalogue.

Unicode — UAX 15, formes de normalisation, révision 58 · mise à jour par la source le 12/08/2026 · consultée le 22/10/2026. Les contrôles proposés sont une lecture éditoriale de cette référence.

Comparer deux libellés et voir leurs points de code.

Booking.com Demand : un frais exclu du prix affiché peut rester à payer

Pour expliquer un prix d’hôtel, séparez le total du séjour, les frais encore indéterminés et ce qui sera encaissé en ligne. Un seul indicateur « inclus » ne décrit pas ces trois informations.

• Prix affiché : included et excluded décrivent la position des frais par rapport au prix book ; ils ne désignent pas directement le bénéficiaire du paiement. Ne traduisez pas excluded par « facultatif » ou « non dû ».
• Avant confirmation : Dans /orders/preview et /orders/create, les frais obligatoires calculables sont regroupés dans non_conditional et inclus dans total. Ne rajoutez pas ces lignes une seconde fois au total de réservation.

Modèle Demand API consulté le 22 octobre 2026. Les montants et conditions restent ceux du produit réservé ; cette lecture ne fixe aucun barème fiscal local.

Booking.com Demand — calcul et conditions des frais supplémentaires · consultée le 22/10/2026. Les contrôles proposés sont une lecture éditoriale de cette référence.

Examiner le dossier et son périmètre.

Expedia Rapid : conserver le niveau et la valeur des équipements

Une donnée d’hôtel peut décrire le bâtiment, une chambre ou seulement une formule tarifaire. Cette portée doit suivre l’équipement jusqu’à la fiche présentée au voyageur.

• Trois niveaux : amenities peut être fourni au niveau property, room ou rate plan. Un équipement d’une chambre ou d’un tarif ne doit pas être promis pour toutes les offres de l’hôtel.
• Identifiant et valeur : L’objet contient id, un name localisé et, le cas échéant, value. Les listes de référence indiquent has_value. Gardez la valeur chiffrée lorsque le champ l’exige ; une présence booléenne ne remplace pas une quantité.

Référence du modèle Rapid, sans garantie de disponibilité d’une chambre ni d’adéquation à un besoin d’accessibilité. Confirmer les caractéristiques décisives auprès de l’établissement.

Expedia Rapid — listes de référence du contenu · consultée le 22/10/2026. Les contrôles proposés sont une lecture éditoriale de cette référence.

Examiner le dossier et son périmètre.

Duffel : confirmer le service de siège du bon passager

La présence d’une place sur le plan ne suffit pas à la réserver. Le service sélectionné doit correspondre au passager et apparaître dans la commande obtenue.

• Disponibilité : Un siège sans available_services, représenté par une liste vide, est indisponible dans ce parcours. Ne le proposez pas comme un choix gratuit ou comme une place encore réservable.
• Prix par passager : Un même siège peut avoir un service et un prix différents selon le passenger_id. Conservez le service du voyageur concerné ; ne copiez pas le prix du premier passager pour tous les autres.

Parcours Duffel documenté, sans extension à toutes les compagnies ni garantie de conservation du siège après changement de vol ou d’appareil.

Duffel — Adding Seats, services et commande créée · consultée le 22/10/2026. Les contrôles proposés sont une lecture éditoriale de cette référence.

Examiner le dossier et son périmètre.

FareHarbor : distinguer inscription, alerte et réservation

La liste d’attente peut envoyer plusieurs types de messages. Aucun ne doit être confondu avec une place confirmée.

• Confirmation d’inscription : L’inscription en ligne déclenche toujours un courriel ; l’envoi après ajout manuel est configurable et désactivé par défaut. Distinguez ce message de l’alerte annonçant une place disponible.
• Alerte automatique : Une annulation ou un changement peut déclencher l’alerte après un délai configuré, si la place correspond au type de client. Conservez le type demandé et testez le déclencheur ; l’alerte ne bloque pas la place.

Aide FareHarbor mise à jour le 29 septembre 2026. Les types conditionnels, dont enfant exigeant un adulte, ne fonctionnent pas dans Waitlist.

FareHarbor — fonctionnement de Waitlist · mise à jour par la source le 29/09/2026 · consultée le 22/10/2026. Les contrôles proposés sont une lecture éditoriale de cette référence.

Examiner le dossier et son périmètre.

Google : traiter les URL de filtres vides ou incohérents

Pour les combinaisons que vous choisissez de laisser explorer, la forme des URL et la réponse aux filtres impossibles comptent autant que les libellés.

• Paramètres : Google recommande le séparateur standard & entre paramètres. Évitez les séparateurs ambigus comme une virgule ou un point-virgule.
• Filtres dans le chemin : L’ordre logique doit rester stable, sans filtre dupliqué. Une combinaison ne doit pas produire plusieurs chemins selon l’ordre des clics.

Recommandations Google pour les URL à facettes, consultées le 22 octobre 2026. Elles ne se substituent pas à une stratégie séparée pour les pages éditoriales et les recherches privées.

Google — exploration des URL de navigation à facettes · mise à jour par la source le 18/12/2025 · consultée le 22/10/2026. Les contrôles proposés sont une lecture éditoriale de cette référence.

Expedia Rapid : vérifier combien de voyageurs sont couverts par les repas

Un petit-déjeuner ou une formule tout compris doit rester relié au tarif, aux personnes couvertes et aux restrictions de l’offre.

• Réponse à relire : Expedia recommande les inclusions de la réponse Shop pour l’information tarifaire la plus récente, plutôt que la seule réponse Content. Rapprochez l’offre réellement choisie de la description de l’hôtel.
• Nombre de personnes : Les repas couvrent les clients de la réservation sauf instruction contraire, qui peut notamment apparaître dans le libellé « Breakfast for 2 ». Ne promettez pas trois petits-déjeuners sur la seule présence d’un avantage pour deux personnes.

Modèle Rapid consulté le 22 octobre 2026. Une inclusion ne décrit pas à elle seule les horaires, le lieu de service ou toutes les boissons.

Expedia Rapid — inclusions des formules de repas · consultée le 22/10/2026. Les contrôles proposés sont une lecture éditoriale de cette référence.

Examiner le dossier et son périmètre.

Recharge électrique : distinguer emplacement, point de charge et prise

Si votre partenaire fournit des données OCPI, conservez leur niveau de détail. Le nombre de prises ne donne pas directement le nombre de véhicules pouvant charger ensemble.

• Trois niveaux : Une Location est un lieu regroupant des points de charge (EVSE). Chaque EVSE peut proposer plusieurs prises ou câbles (Connectors), mais ne charge qu’un véhicule à la fois. Ne comptez pas deux connecteurs du même EVSE comme deux places de charge simultanée.
• État du point : AVAILABLE permet de démarrer une session ; BLOCKED décrit un obstacle physique. INOPERATIVE signifie temporairement indisponible sans panne, contrairement à OUTOFORDER. Conservez le statut reçu au lieu de tout résumer par « borne présente ».

Lecture d’OCPI 2.3.0, consultée le 22 octobre 2026. L’hôtel n’est pas présumé connecté à ce protocole ; un statut reçu ne réserve ni une place de parking ni un créneau de recharge.

OCPI 2.3.0 — module Locations · consultée le 22/10/2026. Les contrôles proposés sont une lecture éditoriale de cette référence.

Mews : changer une date de séjour et relire le résultat

Une prolongation ou un départ anticipé demande de rapprocher les nouvelles dates, les conditions financières et la version retrouvée après modification.

• Opération et réservation : reservations/updateInterval modifie le début, la fin ou les deux ; ReservationId identifie la réservation. Gardez l’identifiant Mews avec la version du séjour à modifier.
• Heures transmises : StartUtc et EndUtc sont des dates ISO 8601 en UTC, toutes deux facultatives dans cette opération. Ne transmettez pas une heure locale comme si elle était déjà en UTC.

Connector API consultée le 22 octobre 2026. Modifier l’intervalle ne constitue pas à lui seul une preuve d’accord du client sur le prix, ni un contrôle complet de tous les services liés au séjour.

Mews Connector API — modifier l’intervalle d’une réservation · consultée le 22/10/2026. Les contrôles proposés sont une lecture éditoriale de cette référence.

Examiner le dossier et son périmètre.

Mews Channel Manager : une modification de groupe ne s’envoie pas comme un simple écart

Pour un séjour fractionné, chaque réservation conserve son identité. Le message de groupe doit aussi préserver les éléments qui ne changent pas.

• Définition complète : Lors d’une modification dans un groupe à plusieurs réservations, Mews demande le groupe entier, avec les réservations inchangées ; l’opération ne traite pas les seuls écarts. Préparez un état complet avant de modifier une seule partie du séjour.
• Omission et annulation : Une réservation peut être annulée en lui donnant l’état Canceled, mais aussi en l’omettant de la définition du groupe. Une ligne absente par erreur ne doit pas être interprétée comme une simple absence de changement.

Règles de la Channel Manager API consultées le 22 octobre 2026. Elles ne doivent pas être appliquées automatiquement aux opérations de la Connector API ni aux autres fournisseurs.

Mews Channel Manager API — Process group et réservations · consultée le 22/10/2026. Les contrôles proposés sont une lecture éditoriale de cette référence.

Deliverect Channel : accusé de réception, identifiant et publication du menu

La réussite d’un appel HTTP, la création d’une commande et la mise en ligne d’un menu doivent être suivies comme des résultats distincts.

• Retour HTTP 201 : Deliverect traite les commandes de façon asynchrone : un 201 confirme la réception de la requête, pas la création de la commande. Attendez les observations métier avant de clôturer la transmission comme réussie.
• Identifiant de commande : La FAQ demande un channelOrderId unique, non réutilisable durant les 48 heures suivant le retrait, tous comptes confondus ; un doublon peut être écarté après le 201. Choisissez un identifiant globalement unique ; ne recréez pas une commande pour contourner un statut encore inconnu.

FAQ de l’intégration Channel Deliverect consultée le 22 octobre 2026. La présence d’une fonction dans cette documentation ne prouve pas sa configuration pour un compte. Aucun appel fournisseur, envoi de commande ou publication de menu n’est effectué par cette page.

Deliverect — FAQ des intégrations Channel · consultée le 22/10/2026. Les contrôles proposés sont une lecture éditoriale de cette référence.

Reprise de service : cible, déclenchement et périmètre testé

Un objectif de reprise s’applique à un parcours et à ses dépendances. Le chronomètre, les données nécessaires et la décision de déclencher la reprise doivent être définis ensemble.

• Déclenchement distinct de la cible : Microsoft recommande de définir des seuils de déclenchement de la reprise et de tenir compte des erreurs transitoires. Distinguez le moment où la procédure démarre du délai total attendu pour retrouver la tâche.
• Garanties de plateforme : Microsoft publie des garanties RTO et RPO pour certains produits seulement, selon ce guide. Ne déduisez pas un engagement global de la seule présence du service dans le cloud.

Recommandations Azure Well-Architected consultées le 22 octobre 2026. Elles ne définissent pas le SLA de vos fournisseurs de voyage. Le comparateur utilise des durées fictives ou saisies par le lecteur ; il ne déclenche aucune reprise et ne mesure aucun système.

Microsoft Azure Well-Architected — définir des objectifs de fiabilité · consultée le 22/10/2026. Les contrôles proposés sont une lecture éditoriale de cette référence.

Intl.Collator : signe du résultat, sensibilité et réglages effectifs

Le comparateur du navigateur permet d’observer une règle de tri avec des paramètres précis. Son résultat ne remplace pas l’identifiant d’une fiche ni une règle de rapprochement d’établissements.

• Signe de compare : Un résultat négatif place la première chaîne avant la seconde ; un résultat positif la place après ; zéro ne donne aucun ordre relatif. Testez le signe, sans attendre systématiquement les nombres exacts −1 et 1.
• Sensibilité choisie : ECMA-402 distingue base, accent, case et variant selon les différences de lettres, accents et casse prises en compte. Une égalité de comparaison ne fusionne pas les deux fiches.

ECMA-402, 13e édition de juin 2026, consultée le 22 octobre 2026. L’outil utilise l’implémentation Intl.Collator du navigateur et affiche sa locale résolue ; il ne prétend pas vérifier une version de données Unicode ni reproduire la collation d’une base de données distante.

Ecma International — ECMA-402, 13e édition, juin 2026, Intl.Collator · consultée le 22/10/2026. Les contrôles proposés sont une lecture éditoriale de cette référence.

Cache HTTP : l’accord sur Vary est un contrôle distinct de la fraîcheur

Les exemples ci-dessous isolent la sélection d’une variante. Ils ne constituent pas une configuration de cache pour les prix ou les disponibilités du site.

• Champ absent : Un champ absent ne peut correspondre qu’à une autre demande où il est également absent. Gardez la différence entre un en-tête omis et une préférence envoyée.
• Astérisque : Une réponse stockée dont Vary contient * ne correspond jamais au test de sélection. Ne lisez pas l’astérisque comme « toutes les variantes sont interchangeables ».

RFC 9111 § 4.1, consultée le 22 octobre 2026. La correspondance Vary ne démontre ni fraîcheur, ni autorisation de réutilisation, ni disponibilité commerciale. Une non-correspondance interdit la réutilisation directe de cette variante sans revalidation ; elle ne décrit pas à elle seule tout le parcours réseau.

RFC 9111, section 4.1 — clés de cache et en-tête Vary · consultée le 22/10/2026. Les contrôles proposés sont une lecture éditoriale de cette référence.

MCP : distinguer paramètres d’outil, résultat structuré et erreur d’exécution

La forme technique d’un résultat doit aider à comprendre l’action réellement effectuée. Elle ne remplace ni les droits applicatifs ni la preuve de réservation du fournisseur.

• Entrée et sortie : inputSchema décrit les paramètres ; outputSchema est un schéma facultatif de résultat structuré. Décrivez séparément les dates attendues en entrée et la référence de commande attendue en sortie.
• Origine du résultat : structuredContent contient les données produites par le serveur ; le protocole le distingue des sorties structurées générées par un modèle de langage. Ne prenez pas un JSON rédigé par l’assistant pour une réponse de l’outil fournisseur.

Spécification MCP du 25 novembre 2025, consultée le 22 octobre 2026. Pour chaque fournisseur, rapprochez les outils exposés du contrat, des droits de l’utilisateur et de la preuve métier attendue après l’action.

Model Context Protocol — Tools, version 2025-11-25 · consultée le 22/10/2026. Les contrôles proposés sont une lecture éditoriale de cette référence.

Amazon S3 : un ETag ne remplace pas toujours l’empreinte du fichier entier

Avant de comparer des empreintes de catalogue, relevez la méthode de chargement, l’algorithme et le type de somme de contrôle. Deux valeurs portant des noms proches peuvent couvrir des objets de calcul différents.

• Objet chargé en plusieurs parties : L’ETag d’un objet issu d’un multipart upload n’est pas le MD5 du contenu entier. Ne comparez pas cet ETag à un MD5 local du fichier complet comme s’ils devaient être identiques.
• Deux types de checksum : S3 distingue full object, calculé sur le contenu complet, et composite, construit à partir des sommes de contrôle des parties. Conservez le type avec la valeur et l’algorithme.

Comportement Amazon S3 documenté et consulté le 22 octobre 2026. Complétez la comparaison d’octets par les contrôles du catalogue : dates, devises, prix et références des prestations.

AWS — vérification de l’intégrité des téléversements S3 · consultée le 22/10/2026. Les contrôles proposés sont une lecture éditoriale de cette référence.

JSON Pointer : décoder un jeton et retrouver une valeur exacte

Un pointeur vise une valeur dans un document précis. L’exemple interactif permet de distinguer une clé littérale, un index de tableau et une référence qui ne peut pas être résolue.

• Ordre des échappements : La RFC impose de décoder ~1 avant ~0 : ~01 devient ainsi ~1, et non une barre oblique. Ne réappliquez pas le décodage sur le résultat déjà obtenu.
• Index d’un tableau : Les index commencent à zéro ; les zéros initiaux sont interdits, sauf le jeton 0 lui-même. Dans un tableau, /rooms/01 ne désigne pas le deuxième élément.

RFC 6901 consultée le 22 octobre 2026. Le lecteur de cette page résout uniquement des pointeurs bruts sur un document fictif fixe, sans interprétation de fragment d’URL ni modification du document. Aucun fichier de catalogue réel n’est chargé.

RFC 6901 — JavaScript Object Notation (JSON) Pointer · consultée le 22/10/2026. Les contrôles proposés sont une lecture éditoriale de cette référence.

UUID de dossier : lire la version sans inventer un état métier

Un UUID donne une identité technique. Sa version renseigne sur sa construction ; elle ne dit pas si une réservation est payée, confirmée ou émise.

• UUID version 4 : La RFC réserve 122 bits aux valeurs aléatoires ou pseudo-aléatoires ; les autres bits portent version et variante. Demandez la convention de génération, sans déduire une date de création d’un UUIDv4.
• UUID version 7 : Les 48 premiers bits contiennent un horodatage Unix en millisecondes ; des mécanismes supplémentaires peuvent ordonner les valeurs dans une même milliseconde. Conservez les dates métier séparément et vérifiez la convention avant d’utiliser le tri des identifiants.

RFC 9562 publiée en mai 2024, consultée le 22 octobre 2026. Ces repères décrivent le format et les versions ; les droits d’accès et le rapprochement des références métier restent des contrôles distincts.

IETF — RFC 9562, format et versions des UUID · consultée le 22/10/2026. Les contrôles proposés sont une lecture éditoriale de cette référence.

Compression négociée : en-tête absent, valeur vide et poids q

L’absence d’un en-tête et sa présence avec une valeur vide n’ont pas le même sens. Cette distinction aide à expliquer pourquoi deux clients reçoivent des représentations différentes d’un catalogue.

• En-tête absent ou vide : Sans Accept-Encoding, tout codage est considéré acceptable ; une valeur vide exprime le souhait de ne recevoir aucun codage de contenu. Consignez la présence du champ et sa valeur avant de comparer les réponses de deux clients.
• Poids nul : Un codage accompagné de q=0 est déclaré non acceptable, même s’il figure explicitement dans la liste. N’interprétez pas gzip;q=0 comme une demande de compression gzip.

Sémantique de négociation HTTP consultée le 22 octobre 2026. Les exemples décrivent l’acceptabilité et les préférences ; la représentation disponible et la configuration du serveur déterminent la réponse observée.

IETF — RFC 9110, section 12.5.3 Accept-Encoding · consultée le 22/10/2026. Les contrôles proposés sont une lecture éditoriale de cette référence.

Paramètres de lien : espace, signe plus et valeurs répétées

Un lien de recherche ou de réservation doit transmettre les valeurs voulues. URLSearchParams utilise les règles de formulaire : elles expliquent plusieurs écarts que la seule apparence de l’URL masque.

• Espace et signe plus : La sérialisation form-urlencoded représente l’espace par + ; à la lecture, un + brut est interprété comme un espace. Construisez une valeur contenant un plus littéral avec l’API, puis comparez la valeur relue.
• Liste de paramètres : append ajoute une paire nom-valeur, même si le nom existe déjà. Conservez les valeurs multiples lorsque le contrat attend plusieurs filtres sous le même nom.

URL Standard consulté le 22 octobre 2026. Ces règles concernent URLSearchParams et application/x-www-form-urlencoded ; elles ne définissent pas le contrat de chaque API ni l’interprétation de tous les composants d’une URL.

WHATWG — URL Standard, URLSearchParams et form-urlencoded · consultée le 22/10/2026. Les contrôles proposés sont une lecture éditoriale de cette référence.

JSON Lines : fin de fichier, retours de ligne et type de média

Pour comparer deux livraisons de catalogue, distinguez les lignes de valeurs, leurs séparateurs et le type annoncé. Un fichier peut respecter le format sans répondre au schéma produit attendu.

• Deux fins de ligne prises en charge : Le séparateur est LF ; CRLF est également pris en charge parce que l’espace autour de la valeur JSON est ignoré. Un export Windows ne se rejette pas sur la seule présence de CRLF.
• Dernier séparateur : Le séparateur après la dernière valeur est fortement recommandé, mais pas obligatoire. Distinguez une dernière valeur sans saut final d’une ligne vide ajoutée entre des valeurs.

Description JSON Lines consultée le 22 octobre 2026. Le format ne définit ni le schéma d’un produit touristique ni les règles d’acceptation partielle, de dédoublonnage ou de reprise du lot.

JSON Lines — documentation du format · consultée le 22/10/2026. Les contrôles proposés sont une lecture éditoriale de cette référence.

Pièce jointe : nom décodé, stockage et taille après extraction

Une pièce de dossier passe par plusieurs étapes : nom reçu, contrôle, stockage, puis lecture ou extraction. Les recommandations OWASP apportent des points précis pour préparer les essais du circuit.

• Contrôle du nom : OWASP demande de valider l’extension après décodage du nom et signale les limites des contrôles partiels d’extension. Retrouvez la représentation du nom effectivement vérifiée par le récepteur.
• Nom de stockage : La fiche recommande un nom généré par l’application, avec limites de longueur et de caractères. Séparez le nom présenté au lecteur de la référence utilisée pour stocker la pièce.

Recommandations OWASP consultées le 22 octobre 2026. Les contrôles se combinent selon les formats et l’usage du circuit ; un résultat sur une étape ne démontre pas à lui seul l’admission de la pièce au dossier.

OWASP — File Upload Cheat Sheet · consultée le 22/10/2026. Les contrôles proposés sont une lecture éditoriale de cette référence.

Descriptions fournisseurs : texte affiché, HTML admis et liens

Le même descriptif peut alimenter une fiche riche et un extrait de recherche en texte brut. La recette gagne à distinguer les opérations techniques et leurs consommateurs.

• HTML conservé : OWASP cite DOMPurify comme bibliothèque d’assainissement lorsque l’application doit conserver du HTML. Demandez l’outil réellement retenu, sa configuration et sa version ; son nom seul ne décrit pas votre politique de catalogue.
• Entretien de l’assainisseur : La fiche recommande de mettre régulièrement à jour les bibliothèques d’assainissement, compte tenu des évolutions des navigateurs et des contournements. Conservez des descriptions de recette et rejouez leurs sorties après une mise à jour.

Principes OWASP appliqués à la recette de descriptions externes. Aucune bibliothèque n’est installée par cet exemple ; la validation métier des inclusions et conditions reste un contrôle distinct.

OWASP — Cross Site Scripting Prevention Cheat Sheet · consultée le 22/10/2026. Les contrôles proposés sont une lecture éditoriale de cette référence.

Archives de catalogue : quatre contrôles que le nom du ZIP ne résume pas

La documentation Python fournit des exemples concrets de différences entre opérations sur une archive. Ces repères aident à demander les résultats attendus au responsable de l’import.

• Chemins avec zipfile.Path : La classe zipfile.Path n’assainit pas les noms internes ; leur validation contre les chemins absolus ou les composants .. incombe à l’appelant. Faites identifier l’API réellement utilisée et la destination résolue avant toute écriture.
• Noms internes répétés : open(), read() et extract() acceptent un objet ZipInfo pour cibler un membre, notamment en présence de noms identiques. Le manifeste de recette doit permettre de distinguer deux entrées portant le même nom.

Périmètre : bibliothèque Python 3.14, pas description de toutes les bibliothèques ZIP. Les comportements et protections de votre chaîne d’import se vérifient avec l’équipe technique.

Python 3.14 — documentation du module zipfile · consultée le 22/10/2026. Les contrôles proposés sont une lecture éditoriale de cette référence.

Si le parcours utilise Kubernetes : révision, délai et retour

Ce complément concerne les équipes dont un composant du parcours est effectivement déployé avec un Deployment Kubernetes. Il précise ce que l’historique et les états de cette ressource permettent d’affirmer.

• Création d’une révision : Une révision apparaît lorsque le modèle de Pod .spec.template change ; une modification du nombre de réplicas n’en crée pas. Faites retrouver le changement suivi dans l’historique plutôt que d’assimiler toute opération à une nouvelle version.
• Portée du retour : Le retour à une révision antérieure ne restaure que la partie modèle de Pod du Deployment. Documentez séparément les données, dépendances et dossiers créés depuis la bascule.

Comportements propres aux Deployments Kubernetes. Cette référence ne décrit pas l’hébergement du présent site et ne prouve aucune capacité de retour d’un fournisseur qui utilise une autre chaîne.

Kubernetes — Deployments · consultée le 22/10/2026. Les contrôles proposés sont une lecture éditoriale de cette référence.

Booking.com Demand : produit le moins cher et ordre de la liste

Une réponse peut sélectionner un produit peu cher dans chaque établissement tout en classant les établissements selon un autre critère. La documentation Demand permet de séparer ces deux niveaux.

• Produit par établissement : Par défaut, accommodations/search renvoie le produit disponible le moins cher pour chaque hébergement répondant aux critères. Vérifiez séparément quel produit représente chaque établissement et comment la liste des établissements est ordonnée.
• Sens du classement : La direction de tri par défaut est descending ; le guide demande ascending pour faire remonter les prix les plus bas. Conservez explicitement critère et direction dans la demande et après un retour depuis une fiche.

Périmètre : hébergements dans Booking.com Demand API, selon la version et le contrat applicables. Ces règles ne décrivent pas le classement de tous les moteurs ni un temps de trajet.

Booking.com Demand API — Filtering and sorting accommodation results · consultée le 22/10/2026. Les contrôles proposés sont une lecture éditoriale de cette référence.

Examiner le dossier et son périmètre.

Anomalies : version touchée, cible de correction et dépendances

Une anomalie a plusieurs repères de suivi. La documentation Bugzilla précise des champs qui évitent de confondre état observé, planification et relation entre défauts.

• Version touchée : Dans Bugzilla, Version indique habituellement les versions du produit affectées par le défaut. Gardez la version reproduite même lorsqu’une correction est préparée ailleurs.
• Cible future : Target Milestone désigne une version future visée pour la correction ; sa valeur peut aussi être un autre texte, par exemple une date. Une cible planifiée ne constitue pas une preuve de correction livrée ou vérifiée.

Champs de la documentation Bugzilla 5.0.4 ; installations et circuits locaux peuvent différer. Cette lecture ne définit ni délai contractuel ni priorité automatique du projet.

Bugzilla 5.0.4 — Understanding a Bug · consultée le 22/10/2026. Les contrôles proposés sont une lecture éditoriale de cette référence.

Viator : accusé technique et information du voyageur

Ce circuit distingue la prise en charge technique et le message au client. Le niveau de partenariat change les responsabilités.

• Fenêtre Merchant : Pour les partenaires Merchant, le circuit prévoit un accusé dans les cinq minutes suivant l’annulation ; à défaut, Viator envoie un email au contact support enregistré. Ne faites pas repartir le délai au moment où votre équipe lit la notification.
• Type d’événement : L’accusé de modified-since/acknowledge concerne uniquement eventType CANCELLATION. Une modification et une annulation ne suivent pas automatiquement la même opération d’accusé.

Périmètre du circuit Viator documenté, vérifié le 23 octobre 2026. Un accusé ne prouve ni lecture client ni rapprochement financier.

Viator — Automating supplier cancellations and amendments · publiée le 11/09/2025 · consultée le 23/10/2026. Les contrôles proposés sont une lecture éditoriale de cette référence.

Restaurant : identité de zone et descriptions cohérentes

Dans Actions Center, une zone fait partie de la définition du créneau. Son identité et sa description doivent suivre les échanges, pas seulement l’écran initial.

• Identité stable : room_id identifie la zone et doit rester stable pour permettre le rapprochement avec les anciennes réservations. Gardez une identité durable même lorsqu’un libellé est corrigé.
• Nom de zone : room_name doit désigner une zone de placement ou une expérience prépayée ; le guide déconseille d’associer une room à l’espace général par défaut. Distinguez terrasse, bar et expérience réservée sans transformer chaque note de préférence en zone.

Intégration Reservations End-to-End Actions Center, vérifiée le 23 octobre 2026. L’identité d’une zone ne prouve pas l’affectation physique d’une table.

Google Actions Center — Add dining seating sections · mise à jour par la source le 01/04/2026 · consultée le 23/10/2026. Les contrôles proposés sont une lecture éditoriale de cette référence.

Animaux à l’hôtel : autorisation, frais et ancien champ de dépôt

La référence XML Connectivity distingue plusieurs informations qui ne doivent pas devenir une seule promesse « animaux acceptés ».

• Trois politiques d’accueil : PetsAllowedCode distingue Pets Allowed, Pets Not Allowed et Pets By Arrangements. Une admission sur arrangement reste à confirmer pour le séjour et l’animal concernés.
• Détail requis : Dans la requête de contenu, PetsPolicy est requis lorsque la politique parent vaut Pets Allowed ou Pets By Arrangements. Conservez le détail attendu avec la politique d’accueil, plutôt qu’un simple libellé de filtre.

Référence Booking.com Connectivity, vérifiée le 23 octobre 2026. Elle ne décrit pas le modèle Demand ni une autorisation d’accueil universelle ; confirmez conditions et coûts auprès de l’établissement.

Booking.com Connectivity — PetsPolicy · consultée le 23/10/2026. Les contrôles proposés sont une lecture éditoriale de cette référence.

Google Actions Center : notifier le changement de réservation au bon niveau

Quand le restaurant modifie une réservation dans son propre système, Google doit recevoir la mise à jour correspondante. Une disponibilité remise à jour et une notification de réservation ne décrivent pas le même objet.

• Sens de la notification : BookingNotification, aussi appelé UpdateBooking RTU, informe Google d’une annulation ou d’une modification effectuée dans le système partenaire. Conservez le sens de l’échange ; ne confondez pas cet avis avec une nouvelle demande du voyageur au restaurant.
• Informations modifiables : La page liste startTime, duration et partySize parmi les champs modifiables. Rapprochez heure, durée et taille du groupe avec l’état courant du dossier, sans promettre toutes les modifications pour chaque mode d’intégration.

Documentation de l’intégration Reservations End-to-End. Les réservations asynchrones ont des restrictions spécifiques de modification ; ces repères ne les annulent pas. L’exemple d’annulation documenté utilise updateMask=status et status=CANCELED ; il ne décrit pas un remboursement.

Google Actions Center — BookingNotification Ready · mise à jour par la source le 01/04/2026 · consultée le 23/10/2026. Les contrôles proposés sont une lecture éditoriale de cette référence.

Horaires : distinguer un instant, une heure locale et un fuseau

Un journal d’événements et un rendez-vous récurrent ne se conservent pas forcément sous la même forme. La note de travail explique les informations nécessaires pour convertir ou comparer une date.

• Instant et heure affichée : La note définit un instant comme un point ordonnable dans le temps, tandis qu’une heure locale décrit les champs du calendrier et de l’horloge vus dans un lieu. Conservez l’information qui permet de retrouver l’instant avant de comparer deux événements.
• Heure sans rattachement : Une date ou heure sans fuseau ni décalage peut représenter une valeur flottante, qui n’est pas fixée à un instant unique. Ne lui attribuez pas automatiquement le fuseau du navigateur ou du serveur.

Group Draft Note du groupe Internationalization, publiée le 26 juillet 2025 : ce document de travail n’est pas une Recommandation W3C approuvée. Un décalage résout un instant donné ; il ne remplace pas les règles d’un fuseau pour toute une saison.

W3C — Working with Time and Timezones, Group Draft Note · publiée le 26/07/2025 · consultée le 23/10/2026. Les contrôles proposés sont une lecture éditoriale de cette référence.

Mews : arrêter la synchronisation ne prouve pas que les ventes sont fermées

Pour fermer une distribution hôtelière, vérifiez les ventes encore accessibles sur chaque canal. Le réglage de synchronisation et la fermeture commerciale demandent des preuves distinctes.

• Tarif non synchronisé : Mews peut encore recevoir des réservations d’un tarif non synchronisé, sans envoyer ses mises à jour de prix et de restrictions. N’utilisez pas ce seul réglage comme preuve d’arrêt des ventes.
• Retrait d’une catégorie d’un tarif : La chambre reste réservable via d’autres tarifs synchronisés du channel manager. Inventoriez les couples catégorie–tarif encore ouverts pour les dates à fermer.

Référence Mews consultée le 23 octobre 2026. Les options varient selon l’intégration. Cette grille sert à préparer une fermeture avec les équipes concernées ; elle ne déclenche aucune déconnexion.

Mews — Connect and configure your channel manager integration · consultée le 23/10/2026. Les contrôles proposés sont une lecture éditoriale de cette référence.

Examiner le dossier et son périmètre.

Disponibilité : comparer une durée et un volume de requêtes

Avant de comparer deux engagements, nommez le service rendu : rechercher une offre, créer une commande ou retrouver un billet. Une sonde qui répond ne décrit pas toutes ces opérations.

• Indicateur et cible : Le SLI décrit une mesure ; le SLO en fixe l’objectif. Le SLA ajoute un cadre contractuel. Conserver séparément résultat observé, objectif interne et clause applicable au fournisseur.
• Budget d’erreur : Le budget est la part complémentaire de la cible : 100 % moins le SLO. Appliquer cette part au même dénominateur : minutes ou requêtes éligibles, sans convertir directement les unes en autres.

Le cas utilise un mois de 30 × 24 heures, sans exclusion. Il ne calcule aucun avoir contractuel et ne suppose aucune indépendance entre fournisseurs. Les dossiers affectés restent à traiter même si la cible globale est tenue.

Google SRE Workbook — Implementing SLOs · consultée le 27/10/2026. Les contrôles proposés sont une lecture éditoriale de cette référence.

Calculer avec vos hypothèses et comparer les exemples.

Duffel : lire la limite du point d’accès et l’heure de réouverture

Une recherche bloquée par un quota demande de relire les en-têtes de la réponse. Elle ne prouve pas une panne de la compagnie.

• Quota appliqué : ratelimit-limit donne le plafond de la période et ratelimit-remaining le nombre restant. Conserver le point d’accès et l’environnement ; ne pas recopier le quota d’une autre opération.
• Reprise après 429 : Le code rate_limit_exceeded demande d’attendre le moment indiqué par ratelimit-reset, exprimé comme une date HTTP. Lire une date, pas un nombre de secondes ; éviter de renvoyer immédiatement tous les appels en attente.

Comportement Duffel documenté. Aucune limite de compte ni autorisation de nouvelle réservation ne découle de cet exemple ; une écriture à résultat incertain doit être rapprochée séparément.

Duffel — Response handling · consultée le 27/10/2026. Les contrôles proposés sont une lecture éditoriale de cette référence.

Examiner le dossier et son périmètre.