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

APIBOOK - Zentrale API-Dokumentation
======================================

BESCHREIBUNG
------------
Verwaltet eine zentrale Datenbank aller verwendeten APIs. Speichert URL,
Authentifizierungstyp, Endpoints, Beschreibungen und Verifikationsstatus.
Nutzt SQLite (bach.db) mit Tabelle api_book.

OPERATIONEN
-----------
  bach api add <name> <base_url> [--auth key|oauth|none] [--desc "..."] [--provider "..."] [--tags "a,b"]
    API registrieren oder aktualisieren

  bach api list
    Alle registrierten APIs anzeigen (Status, Auth, Verifikation)

  bach api show <name>
    Detaillierte Informationen einer API (URL, Auth, Endpoints, Beispiele)

  bach api endpoint add <api_name> <METHOD> <path> [--desc "..."]
    Endpoint zu existierender API hinzufügen (z.B. POST /v1/chat/completions)

  bach api verify [<name>]
    Alle APIs oder einzelne API testen (HTTP HEAD-Request, Timeout: 10s)

  bach api search <keyword>
    APIs nach Keyword in Name, Beschreibung, Tags durchsuchen

  bach api remove <name>
    API aus Datenbank löschen

  bach api help
    Diese Hilfe anzeigen

BEISPIELE
---------
  # API registrieren
  bach api add openai https://api.openai.com --auth key --desc "OpenAI API"

  # Mit Provider und Tags
  bach api add github https://api.github.com --auth oauth --provider GitHub --tags "git,development"

  # Endpoint hinzufügen
  bach api endpoint add openai POST /v1/chat/completions --desc "Chat Completion"

  # Suchen und Prüfen
  bach api search openai
  bach api verify openai
  bach api list

  # Details anzeigen
  bach api show github

DATENBANK
---------
  Tabelle: api_book
  Spalten: id, name (UNIQUE), provider, base_url, auth_type, description,
           endpoints_json, examples_json, tags, last_verified, is_active,
           created_at, updated_at, dist_type

DATEIEN
-------
  Handler: hub/apibook.py
  Datenbank: data/bach.db (SQLite)

SIEHE AUCH
----------
  bach.py        - CLI-Einstiegspunkt
  hub/base.py    - BaseHandler Klasse
  data/bach.db   - Datenbank
