kodi
86 lines
818 B
Markdown
86 lines
818 B
Markdown
# 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
|