echolot send

echolot send envoie une requête et écrit le corps de la réponse sur la sortie standard. Donnez-lui une URL, comme vous en donneriez une à curl, ou le chemin d’une requête enregistrée dans un espace de travail, qu’il envoie comme le fait l’app : variables, authentification, scripts et vérifications compris. Il ouvre aussi des sessions WebSocket et Socket.IO et écoute des flux d’événements.

echolot send [<options>] <url>

<url> est une URL, ou le chemin d’un fichier de requête enregistré (.req.toml, .gql.toml ou .mcp.toml) dans le dossier requests d’un espace de travail.

Envoyer une URLCopy Anchor Link

echolot send https://demo.echolot.dev/v1/products/TNT-MH-2P

Le corps va sur la sortie standard : vous pouvez le chaîner (| jq .) ou l’écrire dans un fichier avec -o. Rien d’autre n’est affiché tant que vous ne le demandez pas :

• -i affiche la ligne d’état et les en-têtes avant le corps.
• -v affiche les durées sur la sortie d’erreur : DNS, connexion, TLS, attente et transfert, la taille et l’empreinte du corps, l’adresse distante, la version de TLS, le protocole choisi et les certificats du serveur. Un corps décodé (gzip, Brotli, zstd) montre sa taille avant et après.
• --wire affiche sur la sortie d’erreur les octets exacts envoyés et reçus, tels qu’ils ont été capturés sur le réseau.

Un corps et des en-têtes :

echolot send https://demo.echolot.dev/echo/anything -X POST \
  -H 'Content-Type: application/json' \
  -d '{"sku": "TNT-MH-2P"}' -v

── body ── decoded zstd 257 → 418 bytes
── timing ──
DNS          79.61 ms
Connect      15.65 ms
TLS          28.70 ms
Waiting      19.75 ms
Transfer      0.53 ms
Total       146.36 ms
Body      418 bytes, sha256 01facf0b2388ca67…
Remote    [2606:4700:3031::6815:3cf1]:443
── tls ── TLS 1.3, ALPN h2
CN=echolot.dev
  issuer CN=WE1,O=Google Trust Services,C=US, valid until 30 Jan 2027
Alt-Svc   the server offers HTTP/3 (h3 on port 443); --http3 uses it, and so do later requests on Automatic in the same run

-H conserve l’ordre et la casse de vos en-têtes. --data-file lit le corps depuis un fichier en flux au lieu de le charger en mémoire, ce qui convient aux gros envois. --raw n’envoie aucun en-tête que vous n’avez pas écrit : ni Host, ni Content-Length, ni Accept-Encoding.

Envoyer une requête enregistréeCopy Anchor Link

Donnez le chemin d’un fichier de requête. Echolot trouve l’espace de travail qui l’entoure, résout les {{variables}} avec l’environnement que vous choisissez, exécute les scripts et les vérifications de la requête, et affiche les résultats :

echolot send Alpenglow.echolot/requests/catalog/get-product.req.toml -i

HTTP/2 200 OK
content-type: application/json; charset=utf-8
etag: W/"TNT-MH-2P-1"
…

{
  "sku": "TNT-MH-2P",
  "name": "Matterhorn 2P Tent",
  …
}
── tests ──
✓ Status equals 200
✓ JSON value $.sku equals {{productId}}
2 passed

• -e staging ou --env staging résout avec l’environnement de environments/staging.toml.
• Les variables secrètes viennent des variables ECHOLOT_SECRET_<NAME>, ou du trousseau sur un Mac. Voir secrets.
• Ce que les scripts écrivent dans le journal apparaît sous ── console ──, et les résultats des vérifications et de pm.test sous ── tests ──, sur la sortie d’erreur. Une vérification en échec donne le code de sortie 1.
• Une variable qui ne se résout pas est signalée par un avertissement avant l’envoi de la requête.
• -X, -H, -d et --data-file servent pour les URL ; une requête enregistrée envoie ce que dit son fichier. --timeout, --http1.1, --http2, --http3, --raw, -k, --listen, le proxy et les options de certificat s’appliquent aux deux.

Flux d’événements, WebSocket et Socket.IOCopy Anchor Link

Server-Sent Events. Une réponse text/event-stream est diffusée sur la sortie standard à mesure qu’elle arrive. --listen indique combien de temps écouter : 10 secondes par défaut, 0 jusqu’à ce que le serveur termine le flux.

echolot send https://demo.echolot.dev/v1/orders/events --listen 0

WebSocket. Une URL ws:// ou wss:// ouvre une session. Chaque ligne que vous saisissez (ou que vous chaînez), et -d, est envoyée comme message texte ; les messages qui arrivent s’affichent un par ligne, les messages binaires en Base64. Quand l’entrée se termine, Echolot écoute pendant --listen secondes, puis ferme. --subprotocol propose un sous-protocole et peut être donné plusieurs fois. -i ou -v affiche la réponse de mise à niveau sur la sortie d’erreur.

echo '{"op": "subscribe", "channel": "orders"}' | echolot send wss://demo.echolot.dev/v1/orders --listen 5

Socket.IO. --socketio parle Socket.IO sur une URL http(s):// ou ws(s)://. Chaque ligne d’entrée est un événement : son nom, puis ses arguments JSON (chat {"text": "hi"} ; un tableau donne plusieurs arguments). Les événements s’affichent sous la forme name [arguments], les accusés de réception sous la forme ack id [arguments].

echolot send http://localhost:3001 --socketio --namespace /support --auth '{"token": "demo"}'

Voir Requêtes Socket.IO pour des serveurs sur lesquels essayer cela.

OptionsCopy Anchor Link

Sans --http1.1, --http2 ni --http3, Echolot choisit la version comme le fait le réglage Automatique de l’app. N’en choisissez qu’une seule.

Codes de sortieCopy Anchor Link

Un script de pré-requête qui appelle pm.execution.skipRequest() n’envoie rien et se termine avec le code 0.