Lorsque l’API REST WordPress ne fonctionne pas, l’éditeur de blocs peut refuser d’enregistrer un contenu. Une application externe peut aussi perdre l’accès au site. Pourtant, le problème ne vient pas toujours de WordPress lui-même.
L’API REST permet à WordPress et à des services externes d’échanger des données au format JSON. Elle soutient notamment l’éditeur de blocs et les intégrations. La documentation officielle de l’API REST WordPress précise aussi que les contenus privés et les actions sensibles exigent une authentification appropriée.
La bonne approche consiste donc à repérer le premier maillon qui échoue : accès public, routage, sécurité, authentification ou permissions. Faites un seul changement à la fois et notez le résultat.
Commencez par identifier le symptôme précis
Avant de désactiver une extension ou de modifier une règle serveur, observez le message et le contexte. Une même panne apparente peut cacher des causes très différentes.
- L’éditeur affiche une réponse invalide ou ne peut pas publier : l’API est souvent inaccessible, bloquée ou son JSON est altéré.
- Une intégration externe retourne 401 ou 403 : vérifiez d’abord l’authentification, le compte utilisé et les permissions.
- L’adresse de l’API retourne 404 : examinez les permaliens et les règles de réécriture.
- Une erreur 500 apparaît : cherchez une erreur PHP, un conflit d’extension ou une règle serveur incompatible.
- Seules certaines requêtes échouent : le point de terminaison, la méthode HTTP ou le droit demandé peut être en cause.
Ouvrez une fenêtre privée, puis visitez l’adresse https://votre-domaine.tld/wp-json/. Sur un site où l’API publique est accessible, WordPress doit répondre avec un document JSON. Si vous recevez une page HTML de connexion, un défi de sécurité, une redirection inhabituelle ou une erreur serveur, conservez ce détail : il oriente le diagnostic.
Vérifiez d’abord le routage et les permaliens
Une réponse 404 à /wp-json/ indique souvent que la requête n’atteint pas correctement WordPress. Le site public peut rester fonctionnel, tandis que ses routes techniques échouent.
Enregistrez de nouveau les permaliens
Dans l’administration, ouvrez Réglages > Permaliens, puis cliquez sur Enregistrer les modifications sans modifier la structure. Cette action reconstruit les règles de réécriture gérées par WordPress.
Ensuite, testez de nouveau /wp-json/, l’enregistrement dans l’éditeur et l’intégration concernée. Si le problème disparaît, surveillez tout de même les prochaines modifications du serveur, d’un cache ou d’une extension de sécurité. Pour revoir les choix de structure d’URL sans confondre SEO et dépannage, consultez la configuration des permaliens WordPress.
Comparez les chemins et les méthodes demandées
Une route inconnue ne prouve pas que toute l’API est hors service. Une intégration peut appeler une route supprimée, mal orthographiée ou fournie par une extension inactive. Vérifiez l’adresse complète, la méthode demandée — GET, POST, PUT, PATCH ou DELETE — et la version de l’intégration.
Si la racine /wp-json/ répond, mais qu’une seule route échoue, concentrez l’enquête sur l’extension ou le service qui fournit cette route. Ne réinitialisez pas tout le site pour une erreur localisée.
Interprétez le code HTTP avant de corriger
Le code de réponse réduit rapidement la liste des causes possibles. Il faut toutefois lire aussi le corps de la réponse, car WordPress peut y ajouter un code d’erreur plus précis.
| Réponse observée | Piste prioritaire |
|---|---|
| 401 Non autorisé | Identifiants absents, expirés ou mal transmis. |
| 403 Accès refusé | Pare-feu, règle de sécurité, permission insuffisante ou blocage d’adresse IP. |
| 404 Introuvable | Permaliens, réécriture, mauvaise route ou extension qui ne charge plus. |
| 500 Erreur interne | Erreur PHP, conflit entre extensions, thème ou limite serveur. |
| Réponse HTML au lieu de JSON | Redirection, page de connexion, page de blocage ou message parasite. |
Une erreur 403 mérite une attention particulière. Elle peut être justifiée par une politique de sécurité, mais elle peut aussi bloquer une fonction légitime. Consultez la méthode pour diagnostiquer une erreur 403 sur WordPress avant d’assouplir une protection globale.
Distinguez l’accès public de l’accès authentifié
Une route publique peut répondre sans connexion, alors qu’une création d’article, un téléversement ou la consultation de données privées exige un compte autorisé. Il est donc normal qu’un test public réussisse pendant qu’une action d’écriture échoue.
Dans l’administration WordPress
Lorsque vous utilisez l’éditeur connecté, WordPress s’appuie normalement sur vos témoins de session et sur un jeton temporaire appelé nonce. La documentation officielle sur l’authentification REST explique qu’une requête interne sans nonce valide est traitée comme non authentifiée, même si la personne est connectée dans son navigateur.
Déconnectez-vous, reconnectez-vous, puis rechargez complètement l’éditeur. Si le problème survient seulement dans un navigateur, videz le cache du site et désactivez temporairement les extensions de navigateur qui modifient les requêtes ou la confidentialité.
Pour une application ou une automatisation externe
Évitez de transmettre le mot de passe principal d’un compte à un service tiers. WordPress propose plutôt les mots de passe d’application : des identifiants distincts, révocables et associés à une intégration précise. Ils sont prévus pour les accès programmatiques par API et doivent être utilisés par HTTPS, comme l’indique la documentation sur les mots de passe d’application.
Créez un identifiant distinct pour chaque service. Donnez-lui un nom clair, vérifiez le compte associé, puis révoquez-le si l’intégration n’est plus utilisée. Cette méthode simplifie aussi le diagnostic : vous savez exactement quel accès échoue.
Les permissions du compte restent importantes. Une authentification réussie ne donne pas automatiquement le droit de modifier n’importe quel contenu. Vérifiez donc les rôles et permissions dans WordPress avant d’élever les droits d’un utilisateur.
Isolez les extensions, le thème et les règles de sécurité
Les extensions de sécurité, de cache, d’optimisation ou d’authentification peuvent filtrer l’API. Elles peuvent aussi exiger une connexion pour toutes les routes ou bloquer certaines méthodes HTTP. Un pare-feu externe peut produire le même effet avant même que WordPress reçoive la requête.
Si vous disposez d’un environnement de test, reproduisez-y le problème. Désactivez ensuite une seule extension à la fois, en commençant par celles qui touchent à la sécurité, au cache, aux en-têtes ou aux connexions. Testez après chaque action. Réactivez immédiatement ce qui n’est pas en cause.
Si le problème disparaît après la désactivation d’une extension, cherchez un réglage plus ciblé. Par exemple, une exception limitée à la route ou à l’intégration concernée est préférable à la désactivation complète de la protection.
Les extensions peuvent aussi imposer une authentification à toutes les requêtes REST. La foire aux questions officielle de l’API REST rappelle que désactiver l’API peut briser des fonctions de l’administration WordPress qui en dépendent. Gardez donc accessibles les routes nécessaires, tout en limitant les données sensibles.
Examinez le serveur et les journaux
Si l’API échoue encore avec les extensions écartées, consultez les journaux d’erreurs de l’hébergeur au moment exact du test. Cherchez les erreurs PHP, les limites de ressources, les refus de méthode HTTP et les redirections en boucle.
Pour les requêtes authentifiées, vérifiez aussi que le serveur ou le proxy transmet l’en-tête Authorization jusqu’à WordPress. La documentation officielle signale que certains environnements peuvent retirer cet en-tête, ce qui fait échouer l’authentification malgré des identifiants valides.
Transmettez à l’hébergeur des éléments précis : heure du test, URL appelée, méthode HTTP, code obtenu et extrait de la réponse. Cette information permet d’éviter une intervention trop large et accélère l’analyse.
Validez la correction avec les trois usages concernés
Une correction est complète seulement si elle résout le scénario réel. Testez d’abord la racine de l’API. Ensuite, enregistrez un brouillon dans l’éditeur. Enfin, répétez l’action dans l’application ou l’automatisation qui avait échoué.
Documentez la cause, le réglage modifié et la date. Vous pourrez ainsi repérer une régression après une mise à jour ou un changement d’hébergement. Cette trace aide aussi à conserver une sécurité proportionnée, sans bloquer inutilement les fonctions dont votre site dépend.









