Votre première requête

Cette page vous mène d’un Echolot vide à une requête envoyée et une réponse lue. Elle utilise l’API de démo à l’adresse https://demo.echolot.dev, une boutique fictive d’équipement de plein air qui répond sans aucune configuration.

1. Créer un espace de travailCopy Anchor Link

Un espace de travail est un dossier qui contient vos requêtes, à raison d’un fichier chacune. Commencez par en créer un.

L’espace de travail s’ouvre dans sa propre fenêtre. Il est vide, la page indique donc Cet espace de travail est vide.

2. Créer une requêteCopy Anchor Link

https://demo.echolot.dev/v1/products?category=tents&per_page=5

Inutile d’enregistrer. Echolot écrit la requête dans un fichier .req.toml du dossier de l’espace de travail un instant après que vous avez arrêté de saisir, et le nom de l’espace de travail en bas de la barre latérale indique Tout est enregistré.

3. L’envoyerCopy Anchor Link

Appuyez sur ⌘R, ou choisissez Envoyer. ⌘↩ envoie aussi. Pendant l’exécution, Envoyer devient Annuler (⌘.).

4. Lire la réponseCopy Anchor Link

Le volet de réponse se trouve à côté de la requête (ou en dessous, si vous choisissez la disposition empilée).

• La ligne au-dessus de la réponse indique l’état (200 OK), la durée et la taille. Laissez le pointeur dessus pour les détails : les tailles, la durée de chaque phase (DNS, Connexion, TLS, Attente, Transfert), la connexion TLS et les éventuelles redirections.
• Corps affiche le corps. Les choix d’Affichage au-dessus permettent de le lire de différentes façons : Texte, JSON (formaté), Arbre JSON, et pour d’autres contenus XML, Formulaire, MessagePack ou Aperçu. Echolot choisit le premier d’après le type de contenu. ⌘F recherche du texte dans le corps.
• En-têtes liste les en-têtes de la réponse. L’API de démo place le total dans X-Total-Count et les pages suivantes dans Link.
• Cookies liste les cookies définis par la réponse.
• Brut et Hex montrent les octets tels que reçus. Réseau montre l’échange complet tel qu’il a circulé sur le réseau, envoyé et reçu.
• Tests montre les résultats des vérifications de la requête, une fois qu’elle en a.

Chaque réponse est aussi conservée dans l’historique de la requête (⌘Y), pour que vous puissiez y revenir et la comparer à la suivante.

5. Ajouter une vérificationCopy Anchor Link

Les vérifications s’exécutent après chaque envoi et vous préviennent quand une API cesse de répondre comme il faut.

1. Ouvrez l’onglet Tests de la requête.
2. Choisissez Générer à partir de la réponse…. Echolot propose des vérifications d’après la réponse que vous venez de recevoir : l’état, le type de contenu, des valeurs dans le JSON.
3. Cochez celles que vous voulez et choisissez Ajouter N tests (le bouton compte les vérifications cochées).
4. Envoyez de nouveau. L’onglet Tests de la réponse indique chaque vérification réussie ou en échec.

Scripts et tests présente tous les types de vérification.

Étapes suivantesCopy Anchor Link

• Envoyez un corps : créez une autre requête, réglez la méthode sur POST, l’adresse sur https://demo.echolot.dev/echo/anything et saisissez du JSON dans l’onglet Corps. La démo renvoie ce qu’elle a reçu.
• Copiez la requête en commande cURL avec Requête › Copier en tant que cURL (⌥⌘C), ou générez du code avec Requête › Générer du code… (⌥⌘G).
• Placez l’adresse du serveur dans une variable et ajoutez des environnements : Environnements.
• Repérez-vous dans l’app : La fenêtre.
• Suivez un pas-à-pas plus long : Votre premier espace de travail.