API Overzicht

De Podiumnet API is een REST API waarmee je productie-metadata en mediafiles kan ophalen. De API is gebouwd op het Elody platform.

Base URL


Base URL	`…`

Protocol

HTTPS
JSON request- en responsbodies
UTF-8 encoding

Vereiste headers

Elke request vereist:

Header	Waarde
`Authorization`	`Bearer {token}`
`X-tenant-id`	`podiumnet`

Zie Authenticatie voor hoe je een token verkrijgt.

Paginering

Listendpoints ondersteunen paginering via query parameters:

Parameter	Standaard	Beschrijving
`skip`	`0`	Aantal resultaten om over te slaan
`limit`	`20`	Aantal resultaten per pagina

Voorbeeld:

POST __API_BASE_URL__/entities/filter?skip=20&limit=20

Responsformaat:

json

{
  "count": 42,
  "results": [ ... ],
  "skip": 20,
  "limit": 20,
  "next": "/..."
}

Veld	Beschrijving
`count`	Totaal aantal resultaten
`results`	Array van objecten voor deze pagina
`skip`	Toegepaste skip-waarde
`limit`	Toegepaste limit-waarde
`next`	Aanwezig wanneer er nog meer pagina's zijn

Entiteitstructuur

Entiteiten (producties, mediafiles) gebruiken een consistent formaat:

json

{
  "id": "PR-ABC123",
  "_id": "uuid",
  "type": "production",
  "metadata": [
    { "key": "title", "value": "Voorstellingsnaam" }
  ],
  "relations": [
    { "key": "VE-XYZ789", "type": "refVenues" }
  ],
  "identifiers": ["uuid", "PR-ABC123"],
  "audit": {
    "created": { "at": "2026-01-01T00:00:00Z", "by": "user@example.com" },
    "updated": { "at": "2026-01-02T00:00:00Z", "by": "user@example.com" }
  }
}

metadata: array van { key, value } paren met de inhoudsvelden
relations: koppelingen naar andere entiteiten (venues, companies, ...)
id: leesbaar ID (bv. PR-ABC123)
_id: intern UUID

API Overzicht ​

Base URL ​

Protocol ​

Vereiste headers ​