Dash — ticket-export test

Je test hiermee de verbinding en of de API-sleutel wordt geaccepteerd. Een clientcertificaat is optioneel en via deze tool nu niet te testen.

De API-sleutel wordt alleen in de localStorage van deze browser bewaard. Bewaar geen productiesleutels van derden langer dan nodig. Ticketvelden worden op de proxy weggelaten: de browser (en de Network inspector) krijgt alleen status, meta en het aantal items.

Gebruik

Power BI en andere afnemers halen tickets op via GET /api/v2/external/interface/tickets. Authenticatie gaat altijd met header X-API-KEY. Een clientcertificaat (mTLS) is extra en alleen verplicht als de feature flag API mTLS verplicht op de klantomgeving aan staat.

Deze pagina test of host + API-sleutel een werkende verbinding opleveren. De proxy roept Dash aan en stuurt alleen een samenvatting terug (status, meta, aantal items) — geen ticketvelden.

  1. Maak of kopieer een API-sleutel in Dash: Beheer → Koppelingen → API (link verschijnt als je hieronder een host invult).
  2. Kijk bij Beheer → Feature flags of API mTLS verplicht uit staat. Staat die aan, dan stopt de handshake zonder certificaat — gebruik dan het PowerShell-script.
  3. Vul Dash-host (bijvoorbeeld medemblik.dash.nl) en API-sleutel in. From/till, offset en limit zijn optioneel; limit is voor een test klein (standaard 1, max 10).
  4. Klik Test export. HTTP 200 + een itemCount betekent: de sleutel werkt en de export-API is bereikbaar. 401 = sleutel (of op de server het certificaat) geweigerd; controleer dan de API-log onderaan Beheer → API.

Certificaat (optioneel, niet via deze tool)

Via deze browser-tool kun je het certificaatstuk nu niet testen. Download het PowerShell-script en voer het lokaal uit. Zonder -ClientCertificatePath test je alleen de sleutel (zelfde als hier). Met dat pad + wachtwoord test je mTLS.

.\fetch-ticket-export.ps1 -Url 'https://dash.gemeente.nl' -ApiKey 'token' -Limit 1
.\fetch-ticket-export.ps1 -Url 'https://dash.gemeente.nl' -ApiKey 'token' -ClientCertificatePath 'C:\certs\client.pfx' -ClientCertificatePassword (Read-Host -AsSecureString)
Download fetch-ticket-export.ps1

Snapshot van dash/scripts/fetch-ticket-export.ps1. PKI-clientcertificaat vereist (geen self-signed). Sleutel en certificaat beheer je in Dash, niet in deze tool.

Hostname zonder pad, met of zonder https://. Het export-endpoint wordt automatisch toegevoegd.
Gaat alleen mee als header X-API-KEY, nooit in de querystring.
Optioneel. Formaat YYYY-MM-DD_HH-MM, UTC. Leeg = geen datumbereik.
Maximaal 10; de proxy kapt hoger af. Standaard 1.
Download PowerShell-script