Erreur HTTP 405 : Method Not Allowed

L'erreur HTTP 405 "Method Not Allowed" indique que la méthode HTTP utilisée dans la requête (GET, POST, PUT, DELETE, etc.) n'est pas supportée par la ressource ciblée. Le serveur comprend la requête mais refuse de l'exécuter avec cette méthode.

Cette erreur est fréquente lors du développement d'APIs REST quand la configuration des routes est incorrecte, ou quand un client utilise la mauvaise méthode pour interagir avec un endpoint. Le serveur doit inclure un en-tête "Allow" listant les méthodes acceptées.

Pour le monitoring d'APIs, le 405 signale généralement un problème de configuration plutôt qu'une panne. Cependant, un changement soudain de comportement (un endpoint qui acceptait POST et retourne maintenant 405) mérite une investigation.

Causes principales des erreurs 405

L'erreur 405 peut provenir de plusieurs sources. Voici les causes les plus fréquentes :

• Mauvaise méthode HTTP : Utiliser POST sur un endpoint qui n'accepte que GET, ou envoyer un DELETE quand seul PUT est autorisé.
• Configuration de routage : Le framework ou le serveur web n'a pas de route définie pour cette combinaison URL + méthode.
• Formulaire HTML : L'attribut method du formulaire ne correspond pas à ce qu'attend le serveur (ex: GET au lieu de POST).
• Restriction serveur : Le serveur web (Apache, Nginx) peut bloquer certaines méthodes globalement ou pour certains répertoires.

Les méthodes HTTP expliquées

Comprendre les méthodes HTTP est essentiel pour résoudre les erreurs 405 :

• GET : Récupère une ressource. Ne doit pas modifier l'état du serveur. Peut être mise en cache.
• POST : Crée une nouvelle ressource ou envoie des données. Le corps de la requête contient les données.
• PUT / PATCH : PUT remplace complètement une ressource, PATCH la modifie partiellement. Les deux sont idempotents.
• DELETE : Supprime une ressource. Doit être idempotent (supprimer deux fois = même résultat).

Résolution des erreurs 405

Selon la cause identifiée, voici les solutions à appliquer :

• Vérifier la documentation : Consultez la documentation de l'API pour connaître les méthodes acceptées par chaque endpoint.
• Examiner l'en-tête Allow : La réponse 405 doit contenir un en-tête Allow listant les méthodes acceptées (ex: "Allow: GET, POST").
• Corriger le code client : Modifiez votre code pour utiliser la bonne méthode. Dans fetch() ou axios, vérifiez le paramètre method.
• Configurer le serveur : Si vous contrôlez le serveur, ajoutez la méthode manquante aux routes ou à la configuration serveur.

Exemples de configuration

Voici des exemples pour gérer correctement les méthodes HTTP :

// JavaScript - Spécifier la méthode
fetch("/api/users/123", {
    method: "DELETE"  // ou GET, POST, PUT, PATCH
});

// PHP Laravel - Définir les routes
Route::get("/users", [UserController::class, "index"]);
Route::post("/users", [UserController::class, "store"]);
Route::put("/users/{id}", [UserController::class, "update"]);
Route::delete("/users/{id}", [UserController::class, "destroy"]);

// Express.js - Routes multiples
app.route("/users/:id")
    .get(getUser)
    .put(updateUser)
    .delete(deleteUser);

Définissez explicitement les méthodes acceptées pour chaque endpoint. Utilisez les conventions REST : GET pour lire, POST pour créer, PUT/PATCH pour modifier, DELETE pour supprimer.

Monitoring des méthodes HTTP

MoniTao permet de tester différentes méthodes HTTP :

• Configurer la méthode : Sélectionnez GET, POST, PUT ou DELETE dans la configuration du monitor selon ce que vous testez.
• Tester les endpoints : Créez des monitors distincts pour les différentes méthodes d'un même endpoint si nécessaire.
• Détecter les changements : Un 405 soudain sur un endpoint fonctionnel signale un changement de configuration à investiguer.
• Vérifier l'en-tête Allow : Dans les détails du check, vérifiez que l'en-tête Allow liste les méthodes attendues.

Questions fréquentes sur HTTP 405

Conclusion

L'erreur HTTP 405 Method Not Allowed indique une incompatibilité entre la méthode utilisée et celles acceptées par l'endpoint. Une bonne documentation API et des conventions REST cohérentes préviennent la plupart de ces erreurs.

MoniTao vous permet de configurer la méthode HTTP de chaque monitor, assurant que vos endpoints REST répondent correctement selon la sémantique attendue. Un 405 inattendu signale un changement de configuration à investiguer immédiatement.

Prêt à dormir sur vos deux oreilles ?

Commencez gratuitement, sans carte bancaire.

Créer mon compte Voir les tarifs