429 Too Many Requests — {"message":"Rate limit exceeded"}. Ce message, retourné par l’API Algolia, est apparu sur un site média en pleine actualité chaude, au moment précis où le volume de recherches internes explosait à mesure que les visiteurs cherchaient à approfondir un sujet traité en direct. Huit minutes ont suffi entre le début du pic et la saturation complète du quota mensuel de requêtes de recherche souscrit auprès d’Algolia.
Ce texte reconstitue le diagnostic mené en urgence pendant l’incident, le repli technique mis en place pour ne pas laisser le site sans moteur de recherche fonctionnel, et les ajustements appliqués depuis pour ne plus revivre ce scénario dans les mêmes conditions.
Symptôme : la recherche du site cesse de répondre en pleine actualité
Le plugin d’intégration Algolia utilisé sur ce site relaie chaque recherche effectuée par un visiteur vers l’API Algolia, qui retourne des résultats généralement plus pertinents et plus rapides que la recherche native de WordPress. Pendant le pic de trafic, les recherches ont commencé à échouer silencieusement côté visiteur : la barre de recherche restait fonctionnelle, mais ne retournait plus aucun résultat, sans message d’erreur explicite affiché à l’utilisateur final.
Diagnostic : un quota calibré sur un trafic moyen, pas sur un pic d’actualité
Les journaux d’erreurs côté serveur ont rapidement révélé la cause : chaque appel à l’API Algolia retournait un code HTTP 429 accompagné du message Rate limit exceeded, correspondant au dépassement du nombre de requêtes autorisées sur la période de facturation en cours. L’offre souscrite avait été dimensionnée sur la moyenne de trafic habituelle du site, sans marge suffisante pour absorber un pic d’actualité multipliant par dix le volume de recherches en quelques minutes.
Contrairement à un dépassement de quota d’envoi d’e-mails qui bloque une file d’attente maîtrisable, un dépassement de quota de recherche touche directement l’expérience de chaque visiteur en temps réel, sans marge de manœuvre pour différer les requêtes.
Correctif d’urgence : basculer vers la recherche native de WordPress
Pour ne pas laisser le site sans recherche fonctionnelle le temps de résoudre le dépassement de quota avec Algolia, un filtre a permis de désactiver temporairement l’intégration Algolia et de rebasculer sur la requête WP_Query native de WordPress pour le formulaire de recherche :
add_filter('algolia_searchable_posts_index_settings', function($settings) {
if (get_option('algolia_fallback_actif')) {
return false;
}
return $settings;
});
add_filter('pre_get_posts', function($query) {
if (get_option('algolia_fallback_actif') && $query->is_search() && !is_admin()) {
$query->set('s', get_search_query());
}
});La recherche native, moins pertinente sur le classement des résultats et plus lente sur un volume important de contenus, a néanmoins permis de maintenir un service fonctionnel pendant les heures nécessaires au relèvement du quota Algolia auprès du support commercial.
Prévention : ce qui a changé depuis cet incident
Trois ajustements ont suivi cette interruption :
- Souscription à une offre Algolia avec un palier de marge suffisant pour absorber un pic multiplié par dix, plutôt qu’une offre calée sur la moyenne stricte
- Mise en place d’une alerte automatique dès que la consommation quotidienne dépasse 50 % du quota mensuel réparti sur trente jours
- Activation automatique du repli vers la recherche native dès la détection d’un premier code 429, sans attendre une intervention manuelle
Ce dernier point transforme un incident auparavant géré dans l’urgence en un mécanisme de repli déclenché automatiquement, sans dépendre de la disponibilité immédiate d’un développeur au moment du pic.
Un moteur de recherche externe améliore la pertinence des résultats, jamais au prix de laisser le site sans recherche du tout en cas de dépassement.
En résumé
Un pic de trafic imprévu sur un site média peut saturer un quota d’API en quelques minutes, bien plus vite qu’une progression graduelle de trafic habituelle. Le repli automatique vers la recherche native de WordPress, même moins pertinent, garantit qu’un visiteur trouve toujours quelque chose plutôt que rien, en attendant la résolution du dépassement de quota côté fournisseur.
