1. Erste Schritte

Willkommen beim Kita API Management Tool! Dieses Werkzeug hilft Ihnen bei der Verwaltung Ihrer pyKMS-Daten. Führen Sie die folgenden Schritte aus, um zu beginnen:

1. Anmelden: Melden Sie sich mit Ihrem Administrator-Konto an (Standard: `KT-Admin`).
2. API Konfigurieren: Gehen Sie zum Tab "Konfiguration" und geben Sie die Basis-URL Ihres pyKMS-API-Servers ein (z.B. http://localhost:8000).
3. Bearer Token einfügen: Fügen Sie einen gültigen Bearer Token von einem Eltern-Benutzer ein, der API-Zugriff hat. Wie Sie diesen erhalten, wird im nächsten Abschnitt erklärt.
4. Verbindung testen: Klicken Sie auf "Verbindung testen", um sicherzustellen, dass alles korrekt eingerichtet ist.

2. API-Authentifizierung: Den Bearer Token erhalten

Der Bearer Token ist Ihr Schlüssel zur API. Er wird nicht in diesem Tool generiert, sondern muss direkt von Ihrer pyKMS-API angefordert werden. Dies geschieht über den /api/auth/token Endpunkt.

Schritt-für-Schritt-Anleitung:

1. API-Zugriff im pyKMS-Backend aktivieren (WICHTIG!):

   Melden Sie sich im Admin-Bereich Ihrer pyKMS-Hauptanwendung an. Suchen Sie den Eltern-Benutzer, den Sie für die API-Kommunikation verwenden möchten. Bearbeiten Sie diesen Benutzer und stellen Sie sicher, dass die Option token_access (oder "API-Zugriff erlauben") aktiviert ist. Ohne diese Berechtigung schlägt jeder API-Aufruf fehl!

2. Token anfordern:

   Senden Sie eine POST-Anfrage an den /api/auth/token Endpunkt Ihrer API. Die Anfrage muss im application/x-www-form-urlencoded Format gesendet werden und die Anmeldedaten des Eltern-Benutzers enthalten.

   Hier ist ein Beispiel mit curl:

   curl -X POST "http://IHRE_API_URL/api/auth/token" \
   -H "Content-Type: application/x-www-form-urlencoded" \
   -d "grant_type=password&username=eltern.email@example.com&password=deren_passwort"

3. Token kopieren:

   Wenn die Anfrage erfolgreich ist, erhalten Sie eine JSON-Antwort, die den Token enthält:

   {
     "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
     "token_type": "bearer"
   }

   Kopieren Sie den Wert von access_token.

4. Token im Tool einfügen:

   Fügen Sie den kopierten Token in das Feld "Bearer Token" im "Konfiguration"-Tab dieses Tools ein und speichern Sie.

3. Fehlerbehebung (Troubleshooting)