Méthodes et codes HTTP

La méthode

http est utilisée pour indiquer le fonctionnement du client API qui souhaite effectuer une ressource donnée. Chaque méthode HTTP correspond à une opération spécifique, telle que la création, la lecture, la mise à jour ou la suppression des ressources, et chaque demande pour l'API REST doit inclure la méthode HTTP.

Le principe de travail du protocole HTTP est que le client envoie une demande au serveur et que le serveur répond à ces demandes. Nous envoyons des demandes HTTP en utilisant différentes méthodes HTTP (parfois appelées verbes HTTP) pour effectuer des opérations CRUD (création, lecture, mise à jour, supprimer). Get et Post sont les méthodes HTTP les plus couramment utilisées, mais il existe plus de méthodes HTTP à apprendre. Cet article présentera différentes méthodes HTTP et comment les utiliser lors de la construction et de l'utilisation d'API Web.

Les 9 méthodes HTTP que vous devez comprendre

<.> 1. Obtenez la méthode

Si nous voulons récupérer des données à partir de ressources (telles que des sites Web, des serveurs ou des API), nous leur enverrons des demandes. Par exemple, si nous voulons une liste de clients ou des clients spécifiques, nous enverrons une demande GET au serveur.

Étant donné que la méthode GET ne doit pas modifier les données sur la ressource, mais les lire uniquement (lire uniquement), elle est considérée comme une méthode de sécurité. De plus, la méthode GET est la puissance.

Comment utiliser la méthode GET pour tester l'API?

Lorsque nous voulons tester l'API, notre méthode la plus courante est la méthode GET. Par conséquent, nous nous attendons aux situations suivantes:

Si les ressources sont accessibles, l'API renverra 200 code d'état pour indiquer "OK".

En plus du code d'état 200, le serveur renvoie généralement le texte de réponse au format XML ou JSON. Par exemple, nous nous attendons à ce que le point de terminaison [/ membres] renvoie une liste de membres au format XML ou JSON.

Si le serveur ne prend pas en charge le point de terminaison, le serveur renverra le code d'état 404, indiquant «non trouvé».

Si nous envoyons une demande avec la mauvaise grammaire, le serveur renverra le code d'état 400 pour indiquer une "mauvaise demande".

<.> 2. Post Method

La méthode POST crée de nouvelles ressources à l'arrière (serveur). Le texte de la demande transporte les données que nous souhaitons envoyer au serveur. Ce n'est ni une méthode de sécurité ni une puissance. Nous ne nous attendons pas aux mêmes résultats pour chaque demande d'envoi. Par exemple, les deux mêmes demandes de post créeront deux nouvelles ressources équivalentes avec les mêmes données et les différents ID de ressource.

Lors de l'envoi d'une demande de poste au serveur, nous nous attendons aux situations suivantes: Idéalement, si la demande de poste crée une nouvelle ressource à l'autre extrémité, la réponse doit avoir le code d'état 201, ce qui signifie "créé".

Parfois, l'exécution de la demande de poste ne renvoie pas la ressource dans une URL donnée;

Comment tester le point de terminaison du post

Parce que la méthode post-postse crée des données, nous devons modifier attentivement les données; De plus, assurez-vous de supprimer les ressources créées une fois le test terminé.

Voici quelques suggestions que nous pouvons utiliser pour tester les API qui utilisent la méthode post:

Utilisez la méthode Post pour créer une ressource, elle doit renvoyer le code d'état 201.

Exécutez la méthode GET pour vérifier si la ressource est créée avec succès. Vous devriez obtenir 200 code d'état et répondre à la ressource qui a été créée.

en utilisant des données incorrectes ou incorrectes pour exécuter la méthode post-post pour vérifier si l'opération échoue.

<.> 3. Put Méthode

En utilisant la méthode de demande de put, nous pouvons mettre à jour les ressources existantes en envoyant les données mises à jour comme contenu du texte de la demande au serveur. La méthode de put met à jour les ressources en remplaçant complètement tout celle-ci. S'il est appliqué à une collection de ressources, il remplacera l'intégralité de la collection, veuillez donc l'utiliser attentivement. Le serveur renverra le code d'état de 200 ou 204 après avoir réussi à mettre à jour ses ressources existantes.

Comment utiliser la méthode de put pour tester l'API?

La méthode de put est la puissance, etc., elle modifie la ressource entière, donc pour tester le comportement, nous assurons les opérations suivantes:

Envoyez une demande de vente au serveur plusieurs fois, et il doit toujours renvoyer le même résultat.

Lorsque le serveur termine la demande de put et met à jour la ressource, la réponse doit avoir un code d'état de 200 ou 204.

Une fois le serveur terminé la demande de put, une demande GET est émise pour vérifier si les données sur la ressource ont été mises à jour correctement.

Si l'entrée n'est pas valide ou si le format est une erreur, les ressources ne sont pas autorisées.

<.> 4. Méthode du patch

Patch est une autre méthode HTTP inhabituelle. Semblable à PUT, le correctif met à jour les ressources, mais il ne met à jour que les données, pas toutes les mises à jour. Par exemple, pour des raisons plus précises, la demande [put] Clients / {CustomerID} mettra à jour complètement les champs de l'entité des clients dans les ressources. Cependant, la méthode du correctif met à jour les champs fournis par l'entité client. Généralement, cette modification doit être un format standard, tel que JSON ou XML. Comment tester l'API avec la méthode du patch?

Pour tester l'API en utilisant la méthode du patch, veuillez suivre les étapes discutées dans cet article pour tester l'API avec la méthode PUT et POST. Considérez les résultats suivants:

Envoyez une demande de corrective au serveur;

Exécuter les demandes GET et vérifier si le contenu a été mis à jour correctement.

Si la demande est incorrecte ou si le format est incorrect, l'opération doit échouer.

<.> 5. Supprimer la méthode

Comme son nom l'indique, supprimez les ressources. La méthode de suppression est la puissance, peu importe le nombre d'appels appelés, il renvoie le même résultat.

La plupart des API renvoient toujours le code d'état de 200.

Comment tester le point de terminaison de suppression? Lors de la suppression du contenu sur le serveur, nous devons être prudents. Nous supprimons les données, ce qui est important. Tout d'abord, assurez-vous que la suppression des données est acceptable, puis effectuez les opérations suivantes:

Appelez la méthode Post pour créer de nouvelles ressources. N'utilisez pas de données réelles pour tester la suppression. Par exemple, créez d'abord un nouveau client, puis essayez de supprimer les clients que vous venez de créer.

Envoyez une demande de suppression de ressources spécifiques. Par exemple, demandez [delete] / clients / {client-id} supprimer les clients avec des identifiants clients désignés.

Appelez la méthode GET pour les clients supprimés, et il devrait retourner 404 car les ressources n'existent plus.

<.> 6. Méthode de tête

La méthode de tête est similaire à la méthode GET. Mais il n'a pas de texte de réponse, donc s'il renvoie à tort le texte de réponse, il doit être ignoré. Par exemple, [GET] / Clients Endpoint renvoie la liste des clients dans son texte de réponse. De plus, [Head] / Clients effectuent également la même opération, mais il ne revient pas à la liste des clients. Avant de demander des points de terminaison Get, nous pouvons envoyer la demande de tête pour déterminer la taille du fichier ou des données que nous téléchargeons. Par conséquent, la méthode de tête est sûre et puissante.

Comment tester le point de terminaison de la tête

L'un des avantages de la méthode de la tête est que tant que l'API le prend en charge, nous pouvons tester si le serveur peut être disponible et accessible, et il est beaucoup plus rapide que la méthode GET car elle ne répond pas au texte . Nous espérons que le code d'état obtenu de l'API est de 200. Avant la méthode HTTP, nous pouvons utiliser la méthode de tête pour tester l'API.

<.> 7. Méthode des options

Nous utilisons cette méthode pour obtenir des informations sur les options de communication possibles (méthodes HTTP autorisées) à donner dans le serveur ou à utiliser le numéro d'étoile pour désigner l'ensemble du serveur. Cette méthode est sûre et puissante.

divers navigateurs utilisent la méthode des options pour vérifier si l'opération COR (partage de ressources transmis) sur l'API cible est limitée.

Comment tester les options de terminaison

Selon si le serveur prend en charge la méthode des options, nous pouvons utiliser la méthode des options pour tester le nombre de défauts mortels du serveur. Essayez-le, veuillez considérer les points suivants: Envoyez une demande d'options et vérifiez l'en-tête retournée et le code d'état.

Testez l'échec de la ressource qui ne prend pas en charge la méthode des options.

<.> 8. Méthode de trace

La méthode de trace est utilisée pour le diagnostic. Il utilise le même texte de demande que le texant de demande au serveur avant le client pour créer un test de revers annulaire, et le code de réponse réussi est de 200 ok. La méthode de trace est sûre et puissante.

La méthode de trace peut être dangereuse car elle peut fuir les informations d'identification. Les pirates peuvent utiliser des attaques clients, y compris l'en-tête de vérification de l'identité interne.

Comment utiliser la méthode de trace pour tester l'API?

Envoyez une demande HTTP standard, telle que la demande GET de / API / Status

Remplacez Get To Trace et renvoyez-le.

Vérifiez le contenu du serveur. Si la réponse a les mêmes informations que la demande d'origine, la fonction de trace est activée dans le serveur et le travail est normal.

<.> 9. Connecter la méthode

La méthode de connexion est utilisée pour établir des connexions finales entre les clients et les serveurs. Il construit une connexion à deux voies entre eux, tout comme un tunnel. Par exemple, nous pouvons utiliser cette méthode pour transmettre en toute sécurité des fichiers volumineux entre les clients et les serveurs.

Méthode http Comparez

Résumé de la méthode Crud accepte la demande de la puissance texte de la demande et autre sécurité Obtenir une seule ressource ou un groupe de ressources en lecture Mettez une mise à jour à l'heure de l'intégralité de la mise à jour des ressources est oui Est-il possible de créer une nouvelle création de ressources? Partie de la mise à jour des ressources de renouvellement du correctif Supprimer la suppression des ressources, est-ce ou non? Les options obtiennent les informations sur les opérations autorisées, est-elle lue? L'acquisition à la tête des métadonnées de terminaison lecture est-ce La trace est utilisée pour diagnostiquer l'objectif de la lecture Connect établit une connexion à deux voies entre le client et les ressources -no-

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!