docs: log the streaming api
This commit is contained in:
parent
41aa93c3c7
commit
1a0712144e
1 changed files with 20 additions and 0 deletions
|
|
@ -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.
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue