content_revision

content_revision est un entier monotone par établissement : il augmente à chaque modification du contenu publié (identité, horaires, menus, Carte unifiée). C’est le mécanisme recommandé pour savoir si vous devez re-lire l’API, purger un cache ou relancer un build.

content_revision est commun à tout l’établissement : une seule valeur couvre l’identité, les horaires et les menus. Vous n’avez donc qu’un seul jeton à suivre par établissement.

Caractéristiques

Monotone — strictement croissant. Une valeur plus grande = du contenu plus récent.
Par établissement — une seule valeur pour tout l’établissement, quelle que soit la ressource.
Indépendant de la locale — même valeur pour fr et en : une révision couvre toutes les langues.
Partout — présent sur l’établissement, les horaires, la liste et le détail des menus, et dans le payload webhook.

Détecter un changement

Le principe : stocker la dernière révision connue, la comparer à celle reçue, et re-fetcher seulement si elle est supérieure.

Pseudo-code

revision_recue = reponse.content_revision

si revision_recue > revision_stockee:
    rafraichir le contenu (re-fetch / re-build)
    revision_stockee = revision_recue
sinon:
    rien à faire (contenu inchangé)

Exemple (JavaScript)

Poll + comparaison

const res = await fetch(
  "https://app.lecommis.fr/api/v1/establishments/au-bistrot",
  { headers: { "X-Api-Key": process.env.LECOMMIS_API_KEY } }
);
const data = await res.json();

const lastKnown = Number(await store.get("au-bistrot:revision")) || 0;
if (data.content_revision > lastKnown) {
  await refreshSiteContent(data);                 // re-build / purge cache
  await store.set("au-bistrot:revision", data.content_revision);
}

Cache et clés par locale

Comme content_revision est commun à toutes les locales, une même valeur invalide à la fois fr et en. Le contenu des menus, lui, diffère par locale. Mettez donc la locale dans votre clé de cache, mais utilisez la révision comme jeton d’invalidation :

clé de cache = "au-bistrot:menus:fr:rev67"
clé de cache = "au-bistrot:menus:en:rev67"

Quand la révision passe à 68, les deux clés sont périmées et vous re-fetchez fr et en. Voir Sites multilingues.

Combinez content_revision avec un cache HTTP local pour éviter les appels inutiles, et appliquez un backoff sur les réponses 429. Voir Quotas de requêtes.

Préférez les webhooks au polling

Le polling fonctionne, mais il interroge l’API à intervalle régulier même quand rien ne change. Les webhooks sortants vous notifient en temps réel : leur payload contient déjà content_revision et changed_resources, ce qui vous évite de deviner ce qui a bougé.

Webhooks sortants

L’approche recommandée pour invalider votre cache dès qu’un changement survient.

Démarrer

API

Redirections & fichiers de menu

Webhooks

Langues & i18n

Référence

Évolutions

Caractéristiques

Détecter un changement

Exemple (JavaScript)

Cache et clés par locale

Préférez les webhooks au polling

Webhooks sortants

​Caractéristiques

​Détecter un changement

​Exemple (JavaScript)

​Cache et clés par locale

​Préférez les webhooks au polling

Webhooks sortants

Caractéristiques

Détecter un changement

Exemple (JavaScript)

Cache et clés par locale

Préférez les webhooks au polling