# 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