API:Caching data/fr

Contrôle du cache client
Le protocole HTTP permet de contrôler comment les navigateurs internet et les serveurs proxys mettent le contenu en cache, à l'aide de différentes valeurs spécifiées dans le header. (Ceci marche uniquement pour les requêtes GET.) Cette API permet au client d'affecter deux de ces valeurs,  et, à l'aide de API parameters   et.

indique au navigateur combien de temps la réponse doit-être laissé en cache (en secondes). fait la même chose pour les proxies partagés. En pratique, ce dernier est notamment utilisé comme instruction pour le reverse proxy côté serveur (tel que de Wikimedia)

Les erreurs ne sont jamais placées en cache. Les réponses spécifiques à un utilisateur seront marqué par  afin que le navigateur les mette en cache, mais pas les proxies publics. Currently the API uses a logged-in user's language setting by default, so responses to logged-in users are always private. This can be avoided by adding the  API parameter (T97096).

Improving cache hit ratio
A request is only served from cache if that exact URL has been cached. (E.g. if you make the same request with  and then with , the second won't be able to use the first's cache entry because the different maxage parameter makes the URL different.) If you pass a list of pages as a parameter, you might improve cache hit ratio by sorting and deduplicating them.

Controlling caching from an API module
Caching is specified by the  methods. Typically caching is only going to be a concern in the submodules, which should use   method instead, which they inherit from.