Comment mettre en cache les images OG

Mettre en cache les images OG consiste à servir un aperçu social (social preview) déjà généré depuis un CDN au lieu de le re-rendre à chaque partage. FastOG met en cache les images identiques en périphérie (edge) pendant un an — la même URL renvoie le PNG mis en cache sans être comptabilisé dans votre quota et avec une latence quasi nulle, de sorte que la majeure partie du trafic OG d'un site n'atteint jamais le moteur de rendu.

Pourquoi la mise en cache est importante

Un partage social déclenche une récupération par le robot d'exploration de la plateforme. Si chaque partage était re-rendu, vous épuiseriez votre quota et votre latence sur un contenu identique. Une mise en cache agressive — basée sur le contenu de l'image — transforme « chaque partage compte pour 1 rendu » en « le premier partage compte pour 1 rendu, tous les autres partages sont gratuits ».

Le modèle basé sur le contenu qui le rend possible

FastOG utilise des URL signées par le contenu : l'URL est une fonction pure des paramètres. Titre + modèle identiques → URL identique. Cela signifie :

La périphérie de FastOG conserve l'image sous l'URL.
Le même contenu partagé 10 000 fois → un rendu, un quota consommé, 9 999 accès au cache.
Modifiez le contenu → URL différente → un nouveau rendu.

GET /api/v1/og?title=Hello&template=default&key=...&s=...   → render (1 quota count), then
GET /api/v1/og?title=Hello&template=default&key=...&s=...   → cached (0 counts, instant)
GET /api/v1/og?title=Changed&template=default&key=...&s=... → render (1 quota count)

En-têtes de cache de FastOG

FastOG renvoie Cache-Control: public, max-age=31536000, immutable (un an) pour les images rendues. Une couverture est servie depuis la périphérie de FastOG en deux niveaux : le cache de rendu devant fastog.com, et un stockage d'objets durable derrière lui. Les requêtes répétées sont traitées sans nouveau rendu, et X-FastOG-Worker-Cache dans la réponse indique quel niveau a répondu (HIT, R2, MISS).

Comme la copie durable ne dépend pas du moteur de rendu, les couvertures qui ont été récupérées au moins une fois continuent d'être servies pendant une brève indisponibilité du service de rendu de FastOG — une panne ne fait pas disparaître un aperçu déjà généré. Une couverture qui n'a jamais été rendue auparavant est le seul cas qui nécessite le moteur de rendu, et dans ce cas FastOG répond avec une image plutôt qu'avec une erreur :

Situation	Ce que reçoit un robot d'exploration
Couverture déjà rendue	la couverture, depuis la périphérie ou le stockage durable
Jamais rendue, service de rendu opérationnel	la couverture, rendue à la demande
Jamais rendue, service de rendu brièvement indisponible	l'image propre à la page transportée dans l'URL (votre photo produit), ou une carte neutre — jamais une page d'erreur

Si la requête elle-même est invalide (une signature falsifiée, un title manquant), vous recevez toujours le 4xx correspondant.

Modifier une image déjà publiée

Vous avez modifié	Ce qu'il faut faire
Le contenu (titre, prix, photo)	rien : le contenu est dans l'URL, donc le nouveau contenu correspond à une nouvelle URL et est rendu à neuf
Le modèle ou une valeur par défaut du rendu	incrémentez la version anti-cache (`FASTOG_CACHE_BUST`) afin que chaque URL obtienne un nouveau paramètre `v`
Vous avez besoin que la même URL soit rendue à nouveau	demandez au support de purger cette URL précise — la purge par URL exacte n'est pas exposée via un endpoint public

Les liens déjà partagés continuent de fonctionner et continuent d'afficher l'image qu'ils promettaient, sauf si vous purgez cette URL exacte.

Mise en cache de votre propre og:image (auto-hébergée)

Si vous stockez vous-même les images au lieu d'utiliser le cache de FastOG, appliquez les mêmes règles :

Étape	Détail
Clé de cache = empreinte du contenu	Stockez selon une empreinte des données, pas un nom de fichier modifiable
TTL long	`max-age=31536000, immutable` pour un contenu stable
URLs versionnées	Ajoutez une empreinte/version lorsque le contenu change
CDN en frontal	Laissez le CDN absorber les requêtes répétées

FAQ

Les partages répétés coûtent-ils vraiment 0 rendu ?

Oui. Les URL identiques atteignent le cache périphérique et n’atteignent jamais le moteur de rendu — aucun quota n’est consommé.

Combien de temps FastOG met-il en cache une image ?

Un an (immutable). Bien après le premier rendu, une carte partagée est servie depuis le cache.

Et si je veux qu’une image soit mise à jour (par exemple un prix en direct) ?

Modifiez un paramètre (le prix) → nouvelle URL → nouveau rendu. Le contenu stable reste en cache ; le contenu dynamique se met à jour quand vous le souhaitez.