Обзор
Официальный CLI для Pachca API: авторизация, сообщения, управление пространством — всё из терминала. Каждый метод API доступен как команда с типизированными флагами, валидацией и подсказками. Нужен Node.js 20+.
Быстрый старт
Установка
Подробнее — Установка.
Вход в аккаунт
Сохраните API-токен. Получить его можно в интерфейсе Пачки в разделе Автоматизации > API — подробнее в руководстве Авторизация.
Первый запрос
Готово. Это типизированная команда. Тот же запрос можно сделать и напрямую через pachca api — оба способа описаны в разделе Способы работы.
Без установки — разовый запуск через npx, токен передаётся флагом:
Способы работы
С CLI можно работать двумя способами. Основной — типизированные команды: так написаны все примеры в документации и интеграции. В дополнение есть команда pachca api для прямых запросов и встроенного справочника по API.
Типизированные команды
Каждый метод API — отдельная команда pachca <секция> <действие> с флагами, валидацией и подсказками. Справка по любой команде — флаг --help:
Пропущенные обязательные флаги CLI запросит интерактивно. Флаг -o json переключает вывод в машиночитаемый JSON.
Все команды со всеми флагами — в разделе Справочник команд. Готовые пошаговые рецепты под задачу — Сценарии.
Прямые запросы
Команда pachca api отправляет прямой HTTP-запрос к любому методу — для нестандартных вызовов и отладки. Она же работает как встроенный справочник по API: список эндпоинтов и справку по каждому (параметры, тело, пример) можно получить прямо в терминале, не открывая сайт документации — особенно удобно агентам:
Подробнее — Прямые запросы.