Все разделы

Документация Tetiva

Tetiva — десктопный клиент для API: HTTP, gRPC, GraphQL и WebSocket в одном окне. Коллекции, окружения, cookies и история запросов лежат в SQLite на вашем компьютере, аккаунт нужен только для синхронизации, телеметрию приложение не собирает. В документации описано то, что клиент умеет сегодня: установка, первый запрос, четыре протокола, скрипты и тесты, импорт из Postman, синхронизация и MCP-сервер для агентов.

С чего начать

  • Установка — DMG для macOS, инсталлятор для Windows, системные требования.
  • Быстрый старт — первый запрос за две минуты.
  • Переход с Postman — экспорт v2.1, что переносится, а что придётся переписать руками.

Как устроен клиент

Данные лежат локально. База — файл ~/.tetiva/data.db. Коллекции, окружения и история доступны офлайн, без входа и без сервера.

Сеть — только по вашей команде. Клиент обращается наружу в трёх случаях: вы отправили запрос; включена проверка обновлений (тумблер в настройках); включена синхронизация. Аналитики и отчётов об использовании нет.

Четыре протокола — один интерфейс. Вкладки, коллекции, окружения и авторизация работают одинаково для HTTP, gRPC, GraphQL и WebSocket; различается только редактор запроса.

Скрипты изолированы. Pre-request и post-response скрипты выполняет движок goja: без файловой системы, без сети, с таймаутом в 5 секунд — подробности на странице Скрипты.

Интерфейс приложения английский. Переведены только экран приветствия и подтверждение почты, поэтому названия кнопок и пунктов меню в документации даны так, как они выглядят в приложении: Send, New Request, Manage Environments.

Десктоп-клиент бесплатен и open source — скачать. Разделы документации перечислены ниже: каждая страница закрывает одну тему целиком.

Начало работы

  • Установка

    Установка Tetiva на macOS и Windows: DMG, инсталлятор, системные требования, предупреждение SmartScreen и где приложение хранит данные.

  • Быстрый старт

    Первый запрос в Tetiva за две минуты: коллекция, запрос, URL, отправка по Cmd+Enter и разбор вкладок ответа.

Основные возможности

  • Коллекции

    Как устроены рабочие пространства и коллекции в Tetiva: вложенность, описание в Markdown, множественный выбор, перенос и удаление.

  • Окружения и переменные

    Окружения Tetiva, синтаксис {{var}}, порядок разрешения, подсветка и подсказка при наведении, секретные переменные и переменные из скриптов.

  • Авторизация

    Bearer, Basic и API Key в Tetiva: во что превращается каждый тип, как работает наследование Inherit от коллекции и где авторизация не применяется.

  • Тело запроса

    Шесть типов тела в Tetiva: JSON, XML, Raw, Form Data, Binary и None. Смена типа без потери данных, form-data с файлами и заголовок Content-Type.

  • Скрипты

    Скрипты до и после запроса в Tetiva: полный список pm.*, ограничения песочницы, наследование от коллекции, тесты и консоль.

  • Просмотр ответа

    Панель ответа в Tetiva: вкладки Body, Headers, Cookies и Tests, поиск по телу, большие и бинарные ответы, история запросов.

  • Импорт и экспорт

    Импорт коллекций и окружений Postman v2.1 в Tetiva, экспорт обратно и копирование запроса командой cURL.

  • Горячие клавиши

    Все горячие клавиши Tetiva: отправка и сохранение запроса, вкладки, редакторы, поиск по ответу и работа с деревом коллекций.

Протоколы

  • HTTP-запросы

    Метод, URL, query-параметры, заголовки и cookie в HTTP-запросах Tetiva: что сохраняется, что подставляется и как устроено хранилище cookie.

  • gRPC

    Unary-вызовы gRPC в Tetiva: схема через server reflection или .proto, выбор метода, генерация примера сообщения, metadata и разбор ответа.

  • GraphQL

    GraphQL в Tetiva: интроспекция схемы, выбор операции с генерацией примера, редактор запроса и переменных, браузер схемы и разбор ответа.

  • WebSocket

    WebSocket-запросы в Tetiva: подключение по ws:// и wss://, отправка сообщений, живой лог сессии и то, что из него попадает в историю.

Синхронизация и аккаунт

  • Синхронизация и аккаунт

    Как включить синхронизацию Tetiva Cloud: аккаунт, подтверждение почты, состояния индикатора, работа офлайн и что уезжает на сервер.

Продвинутое

  • MCP-сервер

    Встроенный MCP-сервер Tetiva: включение в настройках, токен доступа, 32 инструмента, подключение Claude Code и Claude Desktop, каталог данных и безопасность.

  • Настройки

    Настройки Tetiva: тема, шрифт редактора, MCP-сервер, проверка обновлений, экран приветствия, а также где лежат база данных и логи.

  • Решение проблем

    Предупреждения SmartScreen и Gatekeeper, запуск Tetiva с логами, перенос и сброс каталога данных, занятый порт MCP и куда сообщать о багах.

Миграция

  • Переход с Postman

    Экспорт коллекции Postman v2.1 и импорт в Tetiva: таблица соответствия концепций, что не переносится и какие pm.*-вызовы работают в скриптах.