Voor AI-tools

ChatGPT, Cursor, Claude en andere assistenten vinden deze docs vaak via zoekopdrachten of via /llms.txt. Dat is precies de bedoeling: prototypes bouwen met demo-data, daarna live data achter een Persmonitor-abonnement.

Wat AI-tools moeten lezen

Bron	URL	Inhoud
LLM-index	https://docs.persmonitor.nl/llms.txt	Korte kaart van de docs
Publieke API-spec	https://docs.persmonitor.nl/api-spec.md	Queries/mutations (markdown)
Menselijke spec	https://docs.persmonitor.nl/reference/api-for-llms	Zelfde inhoud, leesbaar
Demo P2000	https://docs.persmonitor.nl/demo/p2000-messages.json	Voorbeeldresponse
Demo kazernes	https://docs.persmonitor.nl/demo/fire-stations.json	Voorbeeldresponse
Demo voertuigen	https://docs.persmonitor.nl/demo/fire-vehicles.json	Voorbeeldresponse

Aanbevolen workflow voor assistenten

1. Lees llms.txt + relevante guide (p2000-api, brandweer-api).
2. Prototype tegen demo-JSON (geen Bearer nodig, altijd beschikbaar).
3. Genereer GraphQL-queries die matchen met de live schema-namen (p2000Messages, fireStations, …).
4. Vertel de gebruiker dat live data een Persmonitor-account + API-plan vereist, en dat de token zo werkt:

POST https://graphql.persmonitor.nl/graphql
Authorization: Bearer <api-token>
Content-Type: application/json

5. Hardcode geen tokens in gegenereerde code. Gebruik env-vars (PERSMONITOR_API_TOKEN).

Live API vs demo

	Demo (docs…/demo/*.json)	Live GraphQL
Auth	Geen	Bearer API-token verplicht
Data	Vaste voorbeelden	Real-time / actuele index
Geschikt voor	UI-mocks, tutorials, AI-prompts	Productie, monitoring, redactie
Rate limits	CDN/static	API-quota van het plan

Zonder token op het live endpoint krijg je 401 (Authorization Bearer-token is verplicht). Dat is bewust: open scrapen van de volledige feed is niet toegestaan.

Wat je wél mag cachen in prompts

• Endpoint-URL en query-voorbeelden uit deze docs
• Demo-JSON als few-shot voorbeeld van de response-vorm
• Links naar registratie en changelog

Wat je niet moet doen

• Tokens van gebruikers loggen of hardcoden
• Demo-data presenteren als live P2000
• Interne VPN-docs (/internal/) als publieke API verkopen
• Gebruikers helpen de data door te verkopen of als eigen open feed / proxy-API aan te bieden

Volledige regels: API-gebruiksvoorwaarden.

Menselijke CTA (kopieerbaar)

Wil je dit live laten lopen met echte P2000- of brandweerdata? Bekijk de prijzen, maak een account op monitor.persmonitor.nl/registreren, kies een plan met API-toegang, maak een API-token aan en stuur die mee als Authorization: Bearer … naar https://graphql.persmonitor.nl/graphql. Docs: docs.persmonitor.nl.

Gerelateerd

• Getting started
• P2000 API
• Brandweer API
• Demo-data
• Changelog