Référence des méthodes HTTP

• Recherche instantanée dans toutes les méthodes HTTP : notre référence vous permet de rechercher par nom de méthode, description ou cas d'usage en temps réel. Trouvez exactement ce qu'il vous faut - règles d'idempotence, codes de statut ou exigences de corps de requête.
• Fiches dépliables avec sémantique complète : chaque fiche de méthode HTTP se déplie pour afficher la sémantique complète - propriétés sûre/idempotente/cacheable, cas d'usage courants, exigences de corps de requête, codes de statut de succès et d'erreur, et exemples de requêtes prêts à copier.
• Référence des méthodes HTTP en ligne sécurisée : notre référence s'exécute entièrement dans votre navigateur - aucune donnée n'est envoyée à un serveur. Toutes les données de référence sont chargées localement, l'outil fonctionne donc entièrement hors ligne une fois la page chargée.
• Référence des méthodes HTTP sans installation, 100 % gratuite : utilisez notre référence directement dans n'importe quel navigateur, sans téléchargement, compte ni publicité. Filtrez par méthode, dépliez toutes les fiches d'un coup et copiez les exemples de requêtes - entièrement gratuit à vie.

• Conception d'API REST : utilisez notre référence des méthodes HTTP pour choisir la bonne méthode lors de la conception d'API REST. Comprenez quand utiliser PUT plutôt que PATCH, ou POST plutôt que PUT, pour créer des endpoints sémantiquement corrects et prévisibles.
• Intégration et débogage d'API : les développeurs intégrant des API tierces utilisent notre référence pour comprendre ce que fait chaque méthode et quels codes de statut attendre. Vérifiez rapidement si une méthode est idempotente avant de réessayer des requêtes échouées.
• Développement back-end : les ingénieurs back-end utilisent notre référence pour implémenter des gestionnaires de routes corrects. Comprenez quelles méthodes exigent un corps de requête, lesquelles doivent renvoyer 201 plutôt que 200, et lesquelles peuvent être mises en cache.
• Développement front-end et client : les développeurs front-end utilisent notre référence pour écrire des appels fetch et Axios corrects. Sachez quand utiliser POST pour les formulaires, GET pour récupérer des données et DELETE pour supprimer des ressources.
• Rédaction de documentation d'API : les rédacteurs techniques utilisent notre référence pour documenter les API avec précision. Référencez la sémantique, les règles d'idempotence et les codes de statut corrects de chaque méthode dans votre documentation OpenAPI ou Swagger.
• Apprentissage et préparation d'entretiens : les développeurs apprenant REST ou préparant des entretiens techniques utilisent notre référence pour maîtriser la sémantique HTTP. Comprenez les méthodes sûres vs idempotentes, le préflight CORS et la différence entre PUT et PATCH.

Les méthodes HTTP (aussi appelées verbes HTTP) définissent l'action à effectuer sur une ressource identifiée par une URL. Elles constituent un élément central du protocole HTTP et la base de la conception d'API RESTful. Les méthodes les plus utilisées sont GET (lire), POST (créer), PUT (remplacer), PATCH (mise à jour partielle) et DELETE (supprimer). D'autres méthodes comme HEAD , OPTIONS , CONNECT et TRACE ont des usages spécialisés. Notre référence des méthodes HTTP couvre toutes les méthodes standard avec leur sémantique, leurs cas d'usage et les détails de requête et de réponse.

1. Parcourez ou recherchez : utilisez la barre de recherche pour trouver n'importe quelle méthode HTTP par nom, description ou cas d'usage. Ou cliquez sur une pastille de filtre (GET, POST, PUT, etc.) pour accéder directement à cette méthode. Tout le filtrage s'exécute instantanément dans votre navigateur.
2. Dépliez pour tous les détails : cliquez sur n'importe quelle fiche de méthode pour la déplier et voir la référence complète - propriétés sûre/idempotente/cacheable, cas d'usage, exigences de corps de requête, codes de statut de succès et d'erreur, et exemples de requêtes HTTP. Utilisez « Tout déplier » pour ouvrir toutes les méthodes d'un coup.
3. Copiez les exemples de requêtes : chaque méthode inclut des exemples de requêtes HTTP prêts à copier. Cliquez sur le bouton Copier de n'importe quel exemple pour le copier dans le presse-papiers et l'utiliser dans votre client API, votre documentation ou votre code.

• Sûre : une méthode est sûre si elle ne modifie pas l'état du serveur. GET, HEAD et OPTIONS sont sûres - elles ne font que récupérer de l'information. POST, PUT, PATCH et DELETE ne sont pas sûres car elles modifient des données sur le serveur.
• Idempotente : une méthode est idempotente si répéter la même requête plusieurs fois produit le même résultat qu'une seule fois. GET, HEAD, OPTIONS, PUT et DELETE sont idempotentes. POST ne l'est pas - envoyer deux fois le même POST crée généralement deux ressources.
• Cacheable : une méthode est cacheable si ses réponses peuvent être stockées et réutilisées. Les réponses GET et HEAD sont cacheables par défaut. Les réponses POST ne le sont qu'avec des en-têtes Cache-Control explicites. Les réponses PUT, PATCH et DELETE ne sont pas cacheables.
• Corps de requête : certaines méthodes portent un corps de requête (POST, PUT, PATCH), d'autres non (GET, HEAD, DELETE, OPTIONS). Envoyer un corps avec GET est techniquement autorisé mais fortement déconseillé et souvent ignoré par les serveurs.

PUT remplace la ressource entière - vous devez envoyer tous les champs, et tout champ non inclus sera mis à null ou à sa valeur par défaut. Utilisez PUT lorsque vous voulez remplacer complètement une ressource. PATCH applique une mise à jour partielle - seuls les champs envoyés sont modifiés et tous les autres restent inchangés. Utilisez PATCH lorsque vous n'avez besoin de mettre à jour qu'un ou quelques champs. En pratique, la plupart des API REST modernes préfèrent PATCH pour les mises à jour car c'est plus efficace et moins sujet aux erreurs que d'envoyer la ressource entière à chaque mise à jour.