docs: log the streaming api

This commit is contained in:
Justin Visser 2026-08-10 13:46:56 +02:00
parent 41aa93c3c7
commit 1a0712144e

View file

@ -110,3 +110,23 @@ Wat ik heb laten vallen of uitgesteld:
geverifieerde pool. Sneller en consistent, maar een refinement haalt
geen nieuwe nummers op. Dit is een bewuste afweging, mocht er tijd over
zijn is dit 1 van de uitbreidingen die ik op zou kunnen pakken.
### Streaming API
Wat ik deed:
- De pipeline als streamend endpoint: POST /api/recommendations levert
NDJSON events (metadata / track / warning / error / done); een
client-disconnect stopt de stream en de grounding.
- Playlist-endpoint dat schrijft met een vaste naam-prefix, zodat
aangemaakte playlists later in bulk op te ruimen zijn.
- Request-timing middleware met per-request counters (Spotify calls, cache
hits, LLM tokens) in gestructureerde logs.
- Seed session voor gehost draaien: in live mode installeert een refresh
token bij startup een sessie, zodat een publieke instantie werkt zonder
interactieve login.
Waarom:
- Streamen maakt de wachttijd eerlijk: de eerste kaart telt, niet de
laatste. Een afgebroken request mag geen werk laten doorlopen.