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 geverifieerde pool. Sneller en consistent, maar een refinement haalt
geen nieuwe nummers op. Dit is een bewuste afweging, mocht er tijd over 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. 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.