httplan — исполняемый HTTP-документ | Мой цифровой сад

httplan — исполняемый HTTP-документ

расширение .http файлов слоем планирования исполнения; файл описывает зависимости между операциями, а не последовательность действий

httplan — исполняемый HTTP-документ

httplan — это расширение привычного .http-формата (HTTP Client), которое сохраняет его синтаксис, но добавляет второй слой: план исполнения.

Главный принцип:

Файл описывает не последовательность действий, а набор HTTP-операций и зависимости между ними. План исполнения выводится автоматически.

Так запись

### Login
POST /login

### Profile
GET /profile
Authorization: Bearer {{ $Login.body.token }}

означает не «сделай Login, потом Profile», а «Profile зависит от Login». Исполнитель сам строит граф Login → Profile.

Совместимость с .http

Любой обычный .http остаётся валидным. Магия появляется только тогда, когда в файле возникают ссылки между результатами или вложенные блоки:

Любой .http является валидным .httplan, но не каждый .httplan — простой .http.

Это и есть граница продукта: сохранить знакомость HTTP Client-файлов и добавить поверх них слой планирования.

Модель исполнения

httplan file → Parser → Execution Graph → Planner → Executor

Planner определяет зависимости, параллельность, циклы, пагинацию и повторные попытки.

Философия

Не «сделай запрос A, потом B, потом C», а:

Ближе всего к четырём источникам сразу: make (зависимости), SQL (декларативный план), n8n (визуальный workflow), HTTP Client (привычный формат).

httplan — не «ещё один workflow-конструктор», а исполняемый HTTP-документ. Главная ценность — не сами Filter/Loop/Retry, а сохранение .http как языка запросов плюс второй слой: ссылки между результатами, контекст и автоматический execution plan.

Источники

Связанные заметки

Evolution