# Portability: UNIVERSAL
# Last validated: 2026-05-17
# Next review: 2027-05-17

API PROBER — обнаружение и документация REST API 
==================================================

ОПИСАНИЕ
------------
Делегировано модулю MODULAR_AGENTS/ApiProber для автоматического обнаружения
и документация по REST API. Сканирует URL-адреса, сохраняет конечные точки и
параметры в локальную базу данных и экспортирует результаты.

ОПЕРАЦИИ
-----------
  зонд <url> [--глубина N] [--delay-ms N] [--max-requests N]
    Образует URL-адрес API. Глубина контролирует глубину рекурсии,
    задержка-мс время ожидания между запросами, лимит макс-запросов.
    Сохраняет результаты в локальную базу данных.

  список
    Перечисляет все известные службы из локальной базы данных.
    Показывает имя, базовый URL-адрес, количество конечных точек и метку времени последней.
    Зондирование на услугу.

  статус <имя службы>
    Подробная информация об услуге: базовый URL, заголовок сервера,
    Конечные точки с методами и статусом аутентификации, статистика запуска проб.

  экспорт <сервис> [--format md|json]
    Экспортирует документацию API для службы в формате Markdown или JSON.
    Формат по умолчанию — Markdown.

  конфигурация [--показать]
    Отображает текущую конфигурацию ApiProber, включая время ожидания.
    Настройки (исправление B36: Connect_timeout_s, read_timeout_s).

ПРИМЕРЫ
---------
  bach api-prober probe https://api.github.com --depth 2
    Опробует GitHub API на глубине 2 и сохранит результаты.

  bach api-prober list
    Показывает все службы, обнаруженные на данный момент.

  bach api-prober status github
    Подробная информация об API GitHub (если есть).

  bach api-prober export github --format json
    Экспортирует документацию GitHub API в формате JSON.

  bach api-prober config
    Показывает текущий тайм-аут и параметры конфигурации.

ФАЙЛЫ
-------
  Обработчик:hub/api_prober.py
  Модуль: MODULAR_AGENTS/ApiProber/ (внешний)
  БД: config.json -> get_db_path()
  Экспорт: config.json -> get_export_dir()

СМОТРИ ТАКЖЕ
----------
  оркестратор справки — ProbeOrchestrator (внутренний механизм обнаружения API)
  обработчик справки — обзор системы обработчика
