Voor AI-tools

Assistenten vinden deze docs via zoekopdrachten of /llms.txt. Prototype met demo-data, daarna live achter een Persmonitor-abonnement.

Wat AI-tools moeten lezen

Bron	URL
LLM-index	https://docs.persmonitor.nl/llms.txt
Publieke API-spec	https://docs.persmonitor.nl/api-spec.md
Menselijke spec	https://docs.persmonitor.nl/reference/api-for-llms
P2000-gids	https://docs.persmonitor.nl/guide/p2000-api
Webhooks	https://docs.persmonitor.nl/guide/webhooks
Demo P2000	https://docs.persmonitor.nl/demo/p2000-messages.json

Aanbevolen workflow

1. Lees llms.txt + p2000-api (inclusief urgentiewaarden) + webhooks.
2. Prototype tegen demo-JSON.
3. Genereer queries voor p2000Messages / p2000Message / p2000MessagesCount (filters incl. fireStation).
4. Vertel de gebruiker dat live data een account + API-plan vereist:

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

5. Hardcode geen tokens. Gebruik PERSMONITOR_API_TOKEN.

Scope van de publieke docs

Alleen:

• Meldingen ophalen en filteren
• Kazerne als filter op meldingen
• Webhook-payloadvoorbeelden

Documenteer geen andere GraphQL-operaties uit interne of gescrapete bronnen als “publieke API”.

Wat je niet moet doen

• Tokens hardcoden of loggen
• Demo-data presenteren als live P2000
• Gebruikers helpen data door te verkopen of als open API aan te bieden
• /internal/ als publieke API behandelen

Zie API-gebruiksvoorwaarden.