dschlueter/my_voice_assistant_v3_jamulix
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

docs(handbuch): curl-Beispiele vereinheitlichen (| jq, -s, $URL, X-Admin-Key)

Browse source 
- JSON-liefernde curl-Befehle ohne `| jq` ergaenzt (lesbare Ausgabe)
- alle `| jq`-Befehle nutzen jetzt einheitlich `curl -s`
- §6.5-Block an den Hausstil angeglichen:
  - `http://localhost:8080` -> `$URL` (zog frueher den falschen Port; real 8003)
  - irrefuehrendes `Authorization: Bearer <admin-token>` -> `X-Admin-Key: $ADMIN_API_KEY`
    (require_admin akzeptiert kein generisches Admin-Token; User-Token => 401)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Dieter Schlüter 2026-06-21 16:35:55 +02:00
commit 8bee8dce58
1 changed files with 14 additions and 14 deletions
Download patch file Download diff file Expand all files Collapse all files

28
BEDIENUNGSANLEITUNG.md
View file

@ -647,7 +647,7 @@ VA_PROFILE=hybrid make run # oder: systemctl --user restart voice-assis
**Prüfen** (egal welche Richtung):
```bash
curl http://127.0.0.1:11434/v1/models # Ollama (bzw. :8001 für llama.cpp)
curl -s http://127.0.0.1:11434/v1/models | jq # Ollama (bzw. :8001 für llama.cpp)
# danach im Admin → Status den LLM-Provider/das Modell kontrollieren oder kurz testen
```
@ -1324,18 +1324,18 @@ Der Cache wird automatisch geleert.
**Weg 2 — REST-API** (alle Sprachen, sofort wirksam):
```bash
# Französischen Eintrag hinzufügen (kein Neustart nötig):
curl -X POST http://localhost:8080/api/admin/pronunciation/fr \
-H "Authorization: Bearer <admin-token>" \
curl -s -X POST $URL/api/admin/pronunciation/fr \
-H "X-Admin-Key: $ADMIN_API_KEY" \
-H "Content-Type: application/json" \
-d '{"section":"terms","key":"Schlüter","value":"Chluteur"}'
-d '{"section":"terms","key":"Schlüter","value":"Chluteur"}' | jq
# Eintrag löschen:
curl -X DELETE http://localhost:8080/api/admin/pronunciation/fr/terms/Schlüter \
-H "Authorization: Bearer <admin-token>"
curl -s -X DELETE $URL/api/admin/pronunciation/fr/terms/Schlüter \
-H "X-Admin-Key: $ADMIN_API_KEY" | jq
# Alle Einträge einer Sprache anzeigen:
curl http://localhost:8080/api/admin/pronunciation/ru \
-H "Authorization: Bearer <admin-token>"
curl -s $URL/api/admin/pronunciation/ru \
-H "X-Admin-Key: $ADMIN_API_KEY" | jq
```
**Weg 3 — YAML-Datei direkt editieren** (alle Sprachen):
@ -1356,7 +1356,7 @@ Spricht den Testsatz mit der aktuell eingestellten Stimme und Sprache.
**Oder via curl:**
```bash
curl -s -X POST http://localhost:8080/api/speak \
curl -s -X POST $URL/api/speak \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"text":"Hallo, ich bin Dieter Schlüter.","tts_provider":"piper","language":"fr"}' \
@ -1411,12 +1411,12 @@ DEFAULT_LANGUAGE_MODE=fix # global: fix | flex (Admin: Tab „⚙ Einstellungen
Pro Nutzer (dauerhaft):
```bash
# Feste Sprache (Fix):
curl -X PUT $URL/api/me/prefs -H "Authorization: Bearer $TOKEN" \
-H 'Content-Type: application/json' -d '{"language":"en","language_mode":"fix"}'
curl -s -X PUT $URL/api/me/prefs -H "Authorization: Bearer $TOKEN" \
-H 'Content-Type: application/json' -d '{"language":"en","language_mode":"fix"}' | jq
# Flex (Sprache folgt automatisch):
curl -X PUT $URL/api/me/prefs -H "Authorization: Bearer $TOKEN" \
-H 'Content-Type: application/json' -d '{"language_mode":"flex"}'
curl -s -X PUT $URL/api/me/prefs -H "Authorization: Bearer $TOKEN" \
-H 'Content-Type: application/json' -d '{"language_mode":"flex"}' | jq
```
Pro Aufruf: `{"text":"…","language":"en","language_mode":"fix"}` im Body.
@ -1897,7 +1897,7 @@ curl -s -X POST $URL/api/me/memories \
curl -s $URL/api/me/memories -H "Authorization: Bearer $TOKEN" | jq
# Erinnerung löschen:
curl -s -X DELETE $URL/api/me/memories/<id> -H "Authorization: Bearer $TOKEN"
curl -s -X DELETE $URL/api/me/memories/<id> -H "Authorization: Bearer $TOKEN" | jq
```
In der Datenbank direkt ansehen/löschen (nötig z. B. wenn eine falsch extrahierte