Linked Open Data

Elke productie, organisatie en mediafile heeft een vast webadres. Open je dat in een browser, dan krijg je de Podiumnet-pagina. Vraag je het op met een Accept-header, dan krijg je hetzelfde record als data, op hetzelfde adres.

Je hebt dus geen apart API-endpoint nodig om een record op te halen waarvan je de link al hebt — de link is de identifier.

Data opvragen in plaats van een pagina

GET {PODIUMNET_URL}/PR-6V8VLIHP0
Accept: text/turtle
Authorization: Bearer {access_token}

@prefix : <https://elody.eu/> .

<{PODIUMNET_URL}/PR-6V8VLIHP0> a :production ;
    :title "Gezelschappen" ;
    :status "archived" ;
    :premiere_date "2026-07-30" ;
    :refBookingAgency <{PODIUMNET_URL}/ORG-JQGB344X> .

De id in de URL is dezelfde id die je terugkrijgt van de API — PR-… voor producties, ORG-… voor organisaties. Zowel de leesbare id als de interne uuid werken.

Beschikbare formaten

Accept	Je krijgt
text/html of geen	De Podiumnet-webpagina
application/json	Het record als JSON, identiek aan de API-respons
text/turtle	RDF in Turtle
application/ld+json	RDF in JSON-LD
application/rdf+xml	RDF/XML
application/n-triples	N-Triples

Stuur je geen Accept-header, of */* — wat de meeste HTTP-clients standaard sturen — dan krijg je de webpagina. Zet de header expliciet om data te krijgen.

Q-waarden werken zoals verwacht: Accept: text/turtle;q=0.9, application/json;q=0.5 geeft Turtle.

Links volgen

Relaties zijn geen losse ids, maar adressen die je kan opvragen. In het voorbeeld hierboven verwijst :refBookingAgency naar {PODIUMNET_URL}/ORG-JQGB344X. Vraag die URL op dezelfde manier op en je krijgt het boekingskantoor, waarvan de identifier exact dat adres is.

GET {PODIUMNET_URL}/ORG-JQGB344X
Accept: text/turtle

<{PODIUMNET_URL}/ORG-JQGB344X> a :organization ;
    :id "ORG-JQGB344X" .

Zo kan een harvester de catalogus doorlopen door links te volgen, in plaats van elk recordtype apart op te vragen.

Hoe de data gestructureerd is

• Het onderwerp van elk record is zijn eigen URL.
• Het soort record is een RDF-type: a :production, a :organization.
• Metadata zijn directe eigenschappen: :title, :status, :premiere_date.
• Relaties verwijzen naar de URL van het gerelateerde record.
• Interne administratie (audit trail, schemaversie) wordt niet gepubliceerd.

Eigenschapsnamen zitten voorlopig in de namespace https://elody.eu/ en volgen de veldnamen uit de API.

Authenticatie

Gebruik hetzelfde token als voor de rest van de API — zie Authenticatie. Geef het mee als Bearer-token:

Authorization: Bearer {access_token}

Requests zonder token worden geweigerd. Er is geen publieke, niet-geauthenticeerde toegang tot de dataformaten.

Meerdere records ophalen

Content negotiation geeft één record per request terug. Om sets van records op te halen gebruik je het filter-endpoint dat beschreven staat bij Producties — dat aanvaardt dezelfde Accept-headers en geeft alle resultaten in het gevraagde formaat terug.