rename-mvp/contracts/API_GOLDEN.md

API_GOLDEN.md

Dit document definieert het API contract.

Agents mogen dit contract niet breken.

---

Health

GET /api/health

response:

{ "status": "ok" }

---

TVDB Login

POST /api/tvdb/login

response:

{ "status": "ok", "issued_at": "...", "expires_at": "...", "renew_after": "..." }

---

TVDB Auth Status

GET /api/tvdb/auth-status

response:

{ "configured": true, "has_token": true, "expires_at": "...", "renew_after": "...", "token_source": "cached" }

---

TVDB Search

GET /api/tvdb/search?q=query

response:

{ "items": [ { "id": "...", "name": "...", "year": "...", "display_name": "..." } ] }

---

Contract Rules

Agents mogen:

• nieuwe velden toevoegen

Agents mogen niet:

• velden verwijderen
• veldnamen wijzigen
• response structuur wijzigen