Producties

Een productie bevat alle metadata van een voorstelling: titel, beschrijving, credits, duur, en koppelingen naar venues, companies en mediafiles.

Producties zoeken

POST /entities/filter
Content-Type: application/json

De requestbody is een JSON-array van filterobjecten. Filters worden gecombineerd met AND.

Alle producties

[
  { "type": "type", "value": "production" }
]

Zoeken op titel

Ondersteunt * als wildcard.

[
  { "type": "type", "value": "production" },
  { "type": "text", "key": ["podiumnet:1|properties.title.value"], "value": "Hamlet*" }
]

Filteren op venue

[
  { "type": "type", "value": "production" },
  { "type": "selection", "key": ["podiumnet:1|properties.ref_venues.value"], "value": "{venue_id}", "match_exact": true }
]

Titel + venue combineren

[
  { "type": "type", "value": "production" },
  { "type": "text", "key": ["podiumnet:1|properties.title.value"], "value": "Hamlet*" },
  { "type": "selection", "key": ["podiumnet:1|properties.ref_venues.value"], "value": "{venue_id}", "match_exact": true }
]

Paginering

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

Responsformaat

{
  "count": 42,
  "results": [
    { "id": "PR-ABC123", "type": "production", "metadata": [...], "relations": [...] }
  ],
  "skip": 0,
  "limit": 20
}

Het veld next verschijnt alleen als er nog meer pagina's zijn.

---

Productie ophalen

GET /entities/{id}

{id} is het leesbaar ID (bv. PR-ABC123) of het UUID.

---

Responsstructuur

{
  "id": "PR-ABC123",
  "_id": "43e99478-04db-42df-8d0e-11be73252344",
  "type": "production",
  "metadata": [
    { "key": "title", "value": "Hamlet" },
    { "key": "subtitle", "value": "Een klassieker hertaald" },
    { "key": "description", "value": "<p>Volledige beschrijving...</p>" },
    { "key": "description_short", "value": "<p>Korte beschrijving...</p>" },
    { "key": "credits", "value": "<p><strong>regie</strong> Jan Janssen</p>" },
    { "key": "status", "value": "published" },
    { "key": "duration", "value": 90 },
    { "key": "premiere_date", "value": "2026-09-01" },
    { "key": "age_category", "value": "12+" },
    { "key": "posters_status", "value": "complete" },
    { "key": "scene_images_status", "value": "partially" },
    { "key": "trailer_status", "value": "status_to_be_determined" }
  ],
  "relations": [
    { "key": "VE-XYZ789", "type": "refVenues" },
    { "key": "CO-DEF456", "type": "refCompanies" },
    { "key": "BA-GHI012", "type": "refBookingAgency" }
  ],
  "identifiers": ["43e99478-04db-42df-8d0e-11be73252344", "PR-ABC123"],
  "audit": {
    "created": { "at": "2026-05-20T16:35:24Z", "by": "user@example.com" },
    "updated": { "at": "2026-05-21T09:40:32Z", "by": "user@example.com" }
  }
}

---

Metadatavelden

key	Type	Beschrijving
title	string	Titel
subtitle	string	Ondertitel
description	string (HTML)	Volledige beschrijving
description_short	string (HTML)	Korte beschrijving (max. 500 tekens)
credits	string (HTML)	Credits
status	enum	concept / published / archived
duration	number	Speelduur in minuten
premiere_date	ISO-datum	Premièredatum
age_category	enum	Leeftijdscategorie (bv. 12+)
language_icon	string	Pad naar taalpictogram

HTML-velden

De velden description, description_short en credits bevatten HTML. Strip de tags of render ze rechtstreeks.

---

Beschikbaarheidsstatus van mediafiles

Elke mediacategorie heeft een statusveld in metadata.

key	Categorie
posters_status	Affiche
scene_images_status	Scenebeelden
trailer_status	Trailer
review_status	Recensies
rider_status	Technische info
framing_status	Omkadering
music_fragments_status	Muziekfragmenten
social_media_status	Social media posts

Mogelijke waarden:

Waarde	Betekenis
status_to_be_determined	Nog niet bepaald
not_applicable	Niet van toepassing
follows_later	Volgt later
partially	Gedeeltelijk beschikbaar
complete	Volledig beschikbaar

---

Relatievelden

type	Beschrijving
refVenues	Gekoppeld(e) venue(s)
refCompanies	Gekoppeld(e) gezelschap/gezelschappen
refBookingAgency	Boekingskantoor
refGenres	Genre(s)
refSeasons	Seizoen(en)

De key in een relatieobject is het ID van de gerelateerde entiteit (bv. VE-XYZ789). Gebruik GET /entities/{key} om de volledige gegevens op te halen.