Dépannage de requête
Si votre requête d'API ne se comporte pas comme prévu, il peut y avoir de nombreuses raisons possibles. Pour savoir quel est le problème, vous pouvez utiliser la console Postman pour résoudre votre requête. Cette page répertorie également les problèmes courants et leurs causes.
Débogage dans la console
Chaque requête envoyée par Postman est enregistrée dans la console, vous pouvez donc voir le détail de ce qui s'est passé lorsque vous avez envoyé une requête. Cela signifie que vous pouvez utiliser la console Postman pour vous aider à déboguer vos requêtes lorsqu'une API ne se comporte pas comme prévu. Garder la console ouverte pendant que vous travaillez augmentera la visibilité de vos appels réseau et des messages de journal pendant le débogage.
La console Postman enregistre les informations suivantes :
- La requête principale ayant été envoyée, y compris tous les entêtes de requête sous-jacents, les valeurs de variables et les redirections
- La configuration du proxy et les certificats utilisés pour la requête
- Informations sur le réseau telles que les adresses IP, les chiffrements et les protocoles utilisés
- Instructions de journalisation et requêtes asynchrones à partir de scripts de test ou de pré-requête
- La réponse brute envoyée par le serveur avant qu'elle ne soit traitée par Postman.
Les résultats du moniteur sont consignés dans une console distincte.
Ouverture de la console
Ouvrez la console en sélectionnant l'icône Console dans le pied de page Postman. Dans l'application de bureau Postman, vous pouvez également sélectionner Ctrl+Alt+C.
Affichage des erreurs de requête à partir de la console
Vous recevrez un message d'erreur si Postman n'est pas en mesure d'envoyer votre requête ou s'il ne reçoit pas de réponse de l'API à laquelle vous avez envoyé la requête. Ce message comprendra un aperçu du problème et un lien vers la console, où vous pourrez accéder à des informations détaillées sur la requête.
Sélectionnez View dans Console pour inspecter les détails de la requête dans la console et en savoir plus sur ce qui n'a pas fonctionné.
Naviguer dans la console
La console affiche les informations réseau ainsi que les entêtes et le corps de la requête et de la réponse pour chaque requête, ainsi que tous les messages de sortie de la console provenant de vos scripts.
Filtrez par type de message de journal sous All Logs. Sélectionnez l'action More dans l'icône More actions pour activer ou désactiver les horodatages et les informations réseau.
La console enregistrera les 5000 derniers messages et 24 heures par défaut. Sélectionnez Clear pour vider la liste.
Utilisation des instructions de journal
L'utilisation d'instructions de journal aux emplacements appropriés dans vos scripts de test (onglet Tests) peut vous aider à déboguer vos requêtes. Postman accepte les instructions de journalisation suivantes :
- console.log()
- console.info()
- console.warn()
- console.error()
- console.clear()
Problèmes communs
Voici la liste des des problèmes les plus communes avec l'envoi d'une requête :
| Problème | Résolution du problème |
|---|---|
| Connectivité | Si Postman ne parvient pas à envoyer votre requête, vous rencontrez peut-être des problèmes de connectivité. Vérifiez votre connexion en essayant d'ouvrir une page dans votre navigateur Web. |
| Pare-feu | Certains pare-feu peuvent être configurés pour bloquer les connexions autres que les navigateurs. Si cela se produit, vous devrez contacter vos administrateurs réseau pour que Postman fonctionne. |
| Configuration proxy | Si vous utilisez un serveur proxy pour effectuer des requêtes, vérifiez votre configuration. Par défaut, Postman utilise les paramètres de proxy configurés dans les paramètres réseau de votre système d'exploitation. La console Postman fournira des informations de débogage concernant les serveurs proxy. |
| Certificats SSL | Vous pouvez rencontrer des problèmes lors de l'utilisation des connexions HTTPS. Vous pouvez désactiver la vérification du certificat SSL dans Paramètres en sélectionnant l'icône des paramètres Settings icon > Settings > General. Si cela ne vous aide pas, votre serveur utilise peut-être une connexion SSL côté client, que vous pouvez configurer en sélectionnant l'icône des paramètres Settings icon > Settings > Certificates. Utilisez la console Postman pour vous assurer que le bon certificat SSL est envoyé au serveur. |
| Certificats clients | Des certificats client peuvent être requis pour votre serveur d'API. Vous pouvez ajouter un certificat client dans Paramètres en sélectionnant l'icône des paramètres Settings icon > Settings > Certificates. |
| URL de requête incorrectes | Si vous utilisez des variables ou des paramètres de chemin avec votre requête, assurez-vous que l'adresse finale est structurée correctement en ouvrant la console, affichant l'URL à laquelle votre requête a été envoyée lors de son exécution. Les variables de requête non résolues peuvent entraîner des adresses de serveur non valides. |
| Protocole incorrect | Vérifiez si vous utilisez https:// au lieu de http:// dans votre URL (ou l'inverse). |
| Délais courts | Si vous configurez un court délai d'expiration dans Postman, la requête peut expirer avant la fin, ce qui entraîne une erreur. Pour éviter ce problème, augmentez le délai d'attente dans Settings en sélectionnant l'icône Settings icon > Settings > General. |
| Réponses invalides | Si votre serveur envoie des erreurs de codage de réponse incorrectes ou des en-têtes non valides, Postman peut ne pas interpréter la réponse. |
| Version TLS | Le Postman prend en charge TLS version 1.2 et supérieure, pouvant ne pas être prise en charge si vous utilisez un navigateur ou un système d'exploitation plus ancien. |
| Erreurs de Postman | Il est possible que Postman envoie des requêtes non valides à votre serveur API. Vous pouvez le confirmer en vérifiant les journaux de votre serveur, s'ils sont disponibles. Si vous pensez que cela se produit, contactez l'équipe Postman à l'aide du suivi des problèmes GitHub. |
| Variables non résolues | Une variable non résolue n'est pas définie dans une étendue active disponible pour la requête dans laquelle elle est utilisée. Pour plus d'informations sur la raison pour laquelle cela se produit et sur la façon de résoudre le problème, consultez Correction des variables non résolues. |
| CORS | Si l'application Web Postman ne parvient pas à envoyer votre demande, vous rencontrez peut-être une erreur CORS (Cross Object Resource Sharing). Assurez-vous que vous utilisez le meilleur agent Postman pour votre requête. |