# SlimVerwijzen Search API

Gebruik SlimVerwijzen-zoekdata in je eigen software. De documentatie beschrijft authenticatie, filters en voorbeelden.

SlimVerwijzen biedt ook de mogelijkheid om zoekdata veilig te integreren in software of proces van een organisatie. Hieronder vind je de authenticatie, endpoints, filters en kant-en-klare implementatiebestanden om te starten.

## Referentie

De SlimVerwijzen Search API is gebouwd als RESTful JSON API voor ontwikkelaars die zoekdata willen integreren.

Werk met RESTful endpoints en JSON responses. HTTP-statuscodes maken successen, validatiefouten, autorisatiefouten en serverfouten voorspelbaar. Publieke endpoints gebruiken de URL-namespace /api/public/v1.

## Authenticatie

API-sleutels zijn JWT-gebaseerd en worden meegestuurd als Bearer-token. Neem

op voor de aanvraag van een sleutel voor de search scope.

Bewaar de sleutel server-side of in een secret store. Plaats API-sleutels nooit in publieke broncode, browserbundels, logs of prompts.

## Zoeken

Met de Search API haal je passende ggz-aanbieders en locaties op uit SlimVerwijzen. Gebruik deze data om zoekervaringen, triageflows of verwijsondersteuning in je eigen software te verrijken.

## Bestanden voor implementatie

Download kant-en-klare bestanden om de Search API te testen of om een agent/LLM-integratie sneller te bouwen.

REST Client bestand

Gebruik dit api.http bestand in editors zoals VS Code of JetBrains om direct verzoeken uit te voeren.

Agent implementation guide

Specificatie voor agentic development met search-endpoints, filters, foutafhandeling en veilige secret handling.