echolot send

echolot send отправляет один запрос и пишет тело ответа в стандартный вывод. Передайте ему URL, как передали бы curl, или путь к сохранённому запросу в рабочем пространстве, и он отправит его так, как это делает приложение: с переменными, авторизацией, скриптами и проверками. Он также открывает сеансы WebSocket и Socket.IO и слушает потоки событий.

echolot send [<options>] <url>

<url> — это URL или путь к сохранённому файлу запроса (.req.toml, .gql.toml или .mcp.toml) в папке requests рабочего пространства.

Отправка URLCopy Anchor Link

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

Тело идёт в стандартный вывод, поэтому его можно передать дальше (| jq .) или записать в файл с -o. Больше ничего не печатается, пока вы не попросите:

• -i печатает строку статуса и заголовки перед телом.
• -v печатает время в стандартный поток ошибок: DNS, подключение, TLS, ожидание и передачу, размер и хеш тела, удалённый адрес, версию TLS, выбранный протокол и сертификаты сервера. У декодированного тела (gzip, Brotli, zstd) показан размер до и после.
• --wire печатает в стандартный поток ошибок точные байты, отправленные и полученные, как они пойманы в сети.

Тело и заголовки:

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 сохраняет порядок и регистр ваших заголовков. --data-file передаёт тело из файла потоком, а не читает его в память, так что подходит для больших загрузок. --raw не отправляет заголовков, которые вы не написали: ни Host, ни Content-Length, ни Accept-Encoding.

Отправка сохранённого запросаCopy Anchor Link

Передайте путь к файлу запроса. Echolot находит рабочее пространство вокруг него, разрешает {{variables}} с выбранным вами окружением, выполняет скрипты и проверки запроса и печатает результаты:

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 или --env staging разрешает запрос с окружением из environments/staging.toml.
• Секретные переменные берутся из переменных ECHOLOT_SECRET_<NAME> или, на Mac, из Связки ключей. См. секреты.
• То, что скрипты выводят в журнал, появляется под ── console ──, а результаты проверок и pm.test — под ── tests ──, в стандартном потоке ошибок. Непройденная проверка даёт код выхода 1.
• Переменная, которая не разрешилась, печатается как предупреждение до отправки запроса.
• -X, -H, -d и --data-file предназначены для URL; сохранённый запрос отправляет то, что написано в его файле. --timeout, --http1.1, --http2, --http3, --raw, -k, --listen, параметры прокси и сертификата действуют для обоих случаев.

Потоки событий, WebSocket и Socket.IOCopy Anchor Link

Server-Sent Events. Ответ с text/event-stream идёт в стандартный вывод по мере поступления. --listen задаёт, как долго слушать: по умолчанию 10 секунд, 0 — пока сервер не завершит поток.

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

WebSocket. URL ws:// или wss:// открывает сеанс. Каждая введённая (или переданная по конвейеру) строка и -d отправляются как текстовое сообщение; приходящие сообщения печатаются по одному в строке, двоичные — в Base64. Когда ввод заканчивается, Echolot слушает ещё --listen секунд и закрывает сеанс. --subprotocol предлагает подпротокол и может быть указан несколько раз. -i или -v печатает ответ на обновление протокола в стандартный поток ошибок.

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

Socket.IO. --socketio говорит на Socket.IO через URL http(s):// или ws(s)://. Каждая входная строка — это событие: его имя, затем аргументы в JSON (chat {"text": "hi"}; массив — это несколько аргументов). События печатаются как name [arguments], подтверждения — как ack id [arguments].

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

Серверы, на которых можно это попробовать, см. в запросах Socket.IO.

ПараметрыCopy Anchor Link

Без --http1.1, --http2 и --http3 Echolot выбирает версию так, как это делает параметр Автоматически в приложении. Выберите только один из них.

Коды выходаCopy Anchor Link

Скрипт перед запросом, который вызывает pm.execution.skipRequest(), ничего не отправляет и завершается с кодом 0.