# Portabilität: UNIVERSAL
# Version: 1.0.0
# Zuletzt validiert: 2026-03-04

API-PROBER - REST-API Erkennung und Dokumentation
==================================================

BESCHREIBUNG
------------
Delegiert an das MODULAR_AGENTS/ApiProber-Modul für die automatische Erkennung
und Dokumentation von REST-APIs. Tastet URLs ab, speichert Endpoints und
Parameter in einer lokalen Datenbank und exportiert die Ergebnisse.

OPERATIONEN
-----------
  probe <url> [--depth N] [--delay-ms N] [--max-requests N]
    Tastet eine API-URL ab. Depth kontrolliert Rekursionstiefe,
    delay-ms die Wartezeit zwischen Requests, max-requests Limit.
    Speichert Ergebnisse in lokale DB.

  list
    Listet alle bekannten Services aus der lokalen Datenbank auf.
    Zeigt Name, Base-URL, Endpoint-Anzahl und Zeitstempel des letzten
    Probings pro Service.

  status <service-name>
    Detaillierte Informationen zu einem Service: Base-URL, Server-Header,
    Endpoints mit Methoden und Auth-Status, Probe-Run-Statistiken.

  export <service> [--format md|json]
    Exportiert API-Dokumentation für einen Service als Markdown oder JSON.
    Default-Format ist Markdown.

  config [--show]
    Zeigt die aktuelle ApiProber-Konfiguration an, einschließlich Timeout-
    Einstellungen (B36-Fix: connect_timeout_s, read_timeout_s).

BEISPIELE
---------
  bach api-prober probe https://api.github.com --depth 2
    Tastet GitHub API mit Tiefe 2 ab und speichert Ergebnisse.

  bach api-prober list
    Zeigt alle bisher erkannten Services.

  bach api-prober status github
    Detaillierte Informationen zur GitHub-API (wenn vorhanden).

  bach api-prober export github --format json
    Exportiert GitHub-API-Dokumentation als JSON.

  bach api-prober config
    Zeigt aktuelle Timeout- und Konfigurationsparameter.

DATEIEN
-------
  Handler: hub/api_prober.py
  Modul: MODULAR_AGENTS/ApiProber/ (extern)
  DB: config.json -> get_db_path()
  Exports: config.json -> get_export_dir()

SIEHE AUCH
----------
  help orchestrator  -- ProbeOrchestrator (interne API-Erkennungs-Engine)
  help handler       -- Handler-Systemübersicht
