kader bestanden toegevoegd

2026-03-07 12:12:54 +01:00
parent 27cee7395f
commit e98abcbb78
9 changed files with 845 additions and 31 deletions
@@ -0,0 +1,85 @@
+# 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