Plek in de Veste API

Een eerste verzoek

Codevoorbeelden

Deze voorbeelden lezen alleen opgeslagen gegevens. De veldnamen zijn hoofdlettergevoelig.

curl --fail --max-time 20 -H "Accept: application/json" \
  "https://plekindeveste.net/local-api/season-availability"

// Node.js 18+ (server-side)
const response = await fetch(
  'https://plekindeveste.net/local-api/season-availability',
  { headers: { Accept: 'application/json' }, signal: AbortSignal.timeout(20000) }
);
if (!response.ok) throw new Error('HTTP ' + response.status);
const matches = await response.json();
for (const match of matches.filter(m => m.isCurrent)) {
  const stand = match.availability;
  console.log(match.Name, stand?.availableCount ?? 'Nog geen meting',
    stand?.capturedAt, stand?.complete);
}

# Python 3, zonder extra pakketten
import json
from urllib.request import Request, urlopen

request = Request(
    'https://plekindeveste.net/local-api/season-availability',
    headers={'Accept': 'application/json'}
)
with urlopen(request, timeout=20) as response:
    matches = json.load(response)
for match in matches:
    if match['isCurrent']:
        stand = match['availability']
        print(match['Name'], stand if stand is not None else 'Nog geen meting')

Importeer openapi.json in bijvoorbeeld een API-client. De voorbeelden hieronder zijn illustratief; aantallen en tijdstippen zijn geen live stand.

Tellingen en tijdstippen

Gegevens begrijpen

Eén stoel telt één keer

vrije verkoop + extra kaartenmarkt = totaal beschikbaar. Het volledige kaartenmarktaantal kan stoelen bevatten die ook vrije verkoop worden aangeboden. Tel daarom alleen het extra kaartenmarktaantal op bij vrije verkoop. De tellingen omvatten standaardplaatsen, geen X/Y-markeringen of andere plaatssoorten.

Een gesloten kaartenmarkt is geen gemeten nul

ShowMarketplaceForEvent in de wedstrijdlijst geeft de huidige openingsstatus aan. Voor historische metingen gebruik je marketplace_status; in het seizoenoverzicht heet dit availability.marketplaceStatus. closed betekent dat de kaartenmarkt expliciet niet beschikbaar was en niet is opgehaald. loaded betekent dat de kaartenmarkt geladen is; nul is dan een geldige waarneming. unavailable is een ophaalfout. unknown betekent dat de openingsstatus niet werd vastgelegd.

De numerieke kaartenmarkttellingen blijven 0 bij een gesloten markt, zodat de totaaltelling blijft kloppen. Zonder eerder aangetoonde opening toon je ‘Nog niet geopend’ in plaats van 0 en teken je geen kaartenmarktmeetpunt. Voor een nul na een eerdere opening geldt de afgeleide markering hieronder. Leid uit oudere nulmetingen met unknown geen openingsdatum af. Gebruik de huidige wedstrijdvlag niet om oude metingen achteraf als gesloten te bestempelen.

Volledigheid en actualiteit

Controleer altijd complete en het tijdstip van de stand. Een ontbrekende meting (null of een lege lijst) is iets anders dan nul beschikbare plaatsen. Het dashboard en seizoenoverzicht geven bij voorkeur de laatste volledige stand. Een nieuwere onvolledige poging kan daardoor een later tijdstip hebben dan de getoonde stand.

Iedere wedstrijd is ongeveer eens per zes uur aan de beurt. Wedstrijden worden over de uren verdeeld. Bij zes wedstrijden wordt elk uur één wedstrijd opgehaald. Fouten, pauzes of wijzigingen in het wedstrijdprogramma kunnen de tussenpoos verlengen of verschuiven.

Tijdzones

Metingen gebruiken ISO 8601 met Z (UTC). EventStartDateTime kan geen tijdzone bevatten: behandel die waarde als UTC. Toon tijden met Europe/Amsterdam om zomer- en wintertijd mee te nemen. Zo is 2026-09-20T12:30:00 in Nederland 14:30.

Een nul na een eerdere opening

Een volledige meting met marketplace_status === 'closed' en nul kaartenmarktaanbod na een eerdere waargenomen opening wordt op de website als afgeleide nul weergegeven. Het seizoenendpoint geeft hiervoor availability.marketplaceInferredZero: true terug. Dit is geen gemeten nul: gebruik deze waarde niet als bewijs van verkochte kaarten of een gemeten daling.

De history-endpoints geven de opgeslagen bronstatus terug en bevatten geen marketplace_inferred_zero-veld. De website berekent die markering zelf uit de chronologische historie, vóór filtering op periode. Een eerdere opening is aangetoond door loaded of positief kaartenmarktaanbod. Een mislukte of onvolledige meting levert nooit een afgeleide nul op.

Samen zitten uit stoelgegevens

Er is geen apart endpoint voor combinaties. Gebruik de dashboardstoelen voor groepen van 2, 3 of 4 beschikbare standaardplaatsen in dezelfde rij, met opeenvolgende Column-waarden. Stoelnummers bewijzen geen fysieke aansluiting. Alle stoelen van een combinatie moeten via dezelfde bron beschikbaar zijn: allemaal RegularAvailable of, bij een geladen kaartenmarkt, allemaal MarketplaceAvailable. Een combinatie met aanbod uit verschillende bronnen is niet gezamenlijk boekbaar. Sla vakken met onbekende capaciteit over en controleer eventuele MarketplaceBundled-voorwaarden in de ticketshop.

Wedstrijdmetadata en opgeslagen details

HomeImageUrl, AwayImageUrl en EventTypeLogoUrl zijn optionele bronvelden; oudere wedstrijden kunnen deze missen. De website kan ontbrekende logo's voor de weergave aanvullen. De API wijzigt daarvoor de opgeslagen metadata niet. data.eventMeta in het dashboard bevat de metadata bij die meting; /events bevat de laatst opgeslagen wedstrijdlijst.

Compatibiliteitsvelden zoals data.events, salesChannels, salesPeriods, ticketTypes en categoryPrices zijn in nieuwe opgeslagen dashboards lege lijsten; filters is een leeg object. Gebruik de getelde beschikbaarheid en stoelvelden. De gewijzigde interne databaseopslag verandert de publieke JSON-structuur niet.

Historie is geen verkoopteller

Een afname kan verkoop, een reservering of ingetrokken aanbod zijn. Vergelijk alleen volledige metingen met dezelfde getelde capaciteit en zonder te grote meetonderbreking. Voor veranderingen in kaartenmarkt en totaal moeten beide eindpunten bruikbare kaartenmarktwaarnemingen bevatten: loaded, of positief aanbod bij een oudere onbekende status. Ontbrekende brongegevens en afgeleide nullen mogen geen gemeten stijging of daling opleveren. Verandering in de vrije verkoop kan bij vergelijkbare volledige metingen wel afzonderlijk worden berekend. Uit een verschil over zes uur kun je niet afleiden in welk afzonderlijk uur kaarten zijn verkocht.

Praktische afspraken

Fouten en zorgvuldig gebruik

{
  "error": "Opgeslagen gegevens zijn tijdelijk niet beschikbaar."
}

• Bewaar antwoorden lokaal en stem verversen af op de zesuursplanning. Gebruik het lichte seizoenendpoint als je alleen totalen nodig hebt.
• Voer verzoeken achter elkaar uit. Haal geen volledige stoeloverzichten op voor een lijst met alleen aantallen.
• Controleer eerst de HTTP-status voordat je JSON verwerkt. Gebruik een timeout en hooguit enkele herpogingen met oplopende wachttijd bij tijdelijke fouten. Respecteer een eventuele Retry-After.
• Er is geen vaste publieke verzoeklimiet of beschikbaarheidsgarantie vastgelegd. De hosting kan verzoeken begrenzen.
• Toon bij hergebruik de datum van de stand. Een link naar Plek in de Veste als bron wordt gewaardeerd.

Deze website is een onafhankelijke tool. De API biedt geen reserverings- of aankoopfunctie en garandeert niet dat een getoonde stoel nog te koop is.