APIPour commencer

Cache et ETag

Cache-Control, ETag et 304 Not Modified : économisez vos requêtes et vos quotas.

Cache-Control#

Les réponses réussies portent Cache-Control: public, max-age=600, stale-while-revalidate=86400 : gardez-les 10 minutes sans redemander, puis revalidez. Les données ne changent qu’aux mises à jour de WoWDB ; la date des données est dans data_updated (racine de l’API) et updated_at (/stats).

Les erreurs ne se gardent pas (no-store), sauf les 404, une minute.

ETag et If-None-Match#

Chaque réponse 200 a un ETag, l’empreinte de son contenu. Renvoyez-le dans If-None-Match : si rien n’a changé, la réponse est 304 Not Modified, sans corps. C’est plus rapide, plus léger, et votre copie locale reste valable.

If-None-Match accepte plusieurs ETag séparés par des virgules, et la forme faible W/"…" que posent certains intermédiaires.

Requête conditionnelle

# Première requête : notez l'ETag.
curl -si https://api.wowdb.assemblee-defias.fr/v1/classic/items/5191 | grep -i etag
# ETag: "…"

# Ensuite : 304 Not Modified, sans corps, tant que la fiche n'a pas changé.
curl -si https://api.wowdb.assemblee-defias.fr/v1/classic/items/5191 \
  -H 'If-None-Match: "…"'