Mise en cache des réponses

L'API GraphQL publique met en cache par défaut les réponses résolues. Lorsqu'un enregistrement est écrit, les réponses en cache qui le référençaient sont supprimées.

Activée par défaut, pour 60 secondes

Chaque modèle qui contient des enregistrements met en cache pendant 60 secondes. Une répétition de la même requête dans cette durée renvoie la réponse stockée sans la résoudre de nouveau. Les modèles ordinaires partagent une entrée entre les appelants qui envoient la même requête. Les modèles dont les enregistrements ont un propriétaire sont mis en cache par propriétaire.

Invalidation après une écriture

Créer, mettre à jour, supprimer, publier ou dépublier un enregistrement supprime chaque réponse en cache qui le référençait. Une réponse de liste est supprimée dès qu'un enregistrement de la liste est modifié, et les modèles sans rapport ne sont pas touchés. L'invalidation s'exécute après la validation de l'écriture : pendant quelques millisecondes, une lecture peut donc encore obtenir la réponse précédente. La durée de vie sert de filet de sécurité si une invalidation est perdue, et si le magasin de cache est injoignable, l'écriture est quand même validée et la lecture suivante se résout normalement.

Réglage et désactivation

La durée de vie et la portée se règlent par modèle, dans la console ou dans votre fichier de config sous cacheControl, et un modèle peut se désactiver complètement. Une requête isolée peut forcer une lecture fraîche avec un en-tête no-cache. Les mutations et les lectures de brouillon ne sont jamais mises en cache.

Lire sa propre écriture

Une réponse de mutation porte l'en-tête X-Foir-Write-Token : envoyez-le à votre lecture suivante et le serveur ne sert une entrée en cache que si elle est au moins aussi récente que cette écriture.

Purge manuelle

Pour les changements que le chemin d'écriture ne voit pas, foir cache purge vide un enregistrement, un modèle ou tout. Une mutation d'actualisation couvre un seul enregistrement dont le contenu a changé dans un autre système.

Lire le détail

Le guide du cache couvre les portées du cache, les réglages par modèle, les en-têtes de requête et l'endpoint partagé pour les CDN.