API VeredAi Knowledge
Interrogez la base de connaissances juridiques de VeredAi par programmation : legislation neerlandaise au niveau des articles, jurisprudence avec textes integraux et legislation europeenne, completees par des resultats en direct des sources officielles.
Ce que vous pouvez construire
Integrez des articles de loi et de la jurisprudence a jour dans vos propres applications, systemes de dossiers ou outils internes. Recherchez en deux langues (neerlandais et anglais), filtrez par juridiction et type de document, et recuperez des documents complets avec une reference source verifiable.
Authentification
Creez une cle API sous Compte, Cles API. Chaque cle est liee a exactement un espace de travail et necessite un abonnement avec acces API. Envoyez la cle comme jeton Bearer.
Authorization: Bearer vk_<jouw-sleutel>Endpoints
| GET /api/knowledge/search | q, lang (nl|en), jurisdiction (NL|BE|DE|EU), type (wetgeving|rechtspraak|eu|decentraal), area, law, date_from (JJJJ-MM-DD), date_to (JJJJ-MM-DD), limit (1-25), offset |
| GET /api/knowledge/documents/{uuid} | id, source, external_id, title, summary, body, url, language, jurisdiction, law_area, document_type, decision_date |
| GET /api/knowledge/health | status, latency_ms, last_success_at, failures_24h |
Exemple
curl -H "Authorization: Bearer vk_..." \
"https://veredai.i-sight.nl/api/knowledge/search?q=transitievergoeding+ontslag&lang=nl&jurisdiction=NL&limit=5"Format de reponse
Chaque resultat contient une URL source cliquable, l'identifiant externe (numero BWB avec article, ECLI ou numero CELEX) et des metadonnees sur la langue, la juridiction et le type de document. Le bloc meta indique le total, les sources consultees et la fraicheur de l'index de connaissances interne.
{
"data": [
{
"id": "7f0c2b1e-2f56-4a3e-9a53-1c9f4f2a6b77",
"source": "wetten.overheid.nl",
"external_id": "BWBR0005290:673",
"title": "Burgerlijk Wetboek Boek 7, artikel 673",
"snippet": "De werkgever is aan de werknemer een transitievergoeding verschuldigd indien ...",
"url": "https://wetten.overheid.nl/jci1.3:c:BWBR0005290&artikel=673",
"language": "nl",
"jurisdiction": "NL",
"document_type": "wetsartikel",
"decision_date": "",
"score": 6
}
],
"meta": {
"total": 14,
"sources_consulted": ["wetten.overheid.nl", "Rechtspraak.nl"],
"index_freshness": {"wetten": {"documents": 12500, "last_harvested": "2026-07-05 04:15:02"}}
}
}Exemples de code
Le meme appel en PHP et en JavaScript. Remplacez vk_... par votre propre cle API.
PHP
$ch = curl_init('https://veredai.i-sight.nl/api/knowledge/search?q=' . urlencode('transitievergoeding ontslag') . '&limit=5');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer vk_...'],
]);
$result = json_decode((string) curl_exec($ch), true);
curl_close($ch);JavaScript
const response = await fetch(
'https://veredai.i-sight.nl/api/knowledge/search?q=transitievergoeding+ontslag&limit=5',
{ headers: { Authorization: 'Bearer vk_...' } }
);
const result = await response.json();Limites et couts
Chaque cle a une limite configurable par minute. Selon la configuration de la plateforme, des credits peuvent etre deduits de l'espace de travail par requete.
Les administrateurs peuvent configurer qu'un nombre fixe de requetes coute ensemble un credit, par exemple 1 credit pour 10 requetes. La limite et les couts actuels de votre espace de travail figurent sur la page Compte, Cles API.
Gestion des erreurs
Les erreurs suivent toujours le meme format JSON avec un code et un message lisible.
{"error": {"code": "rate_limit_exceeded", "message": "..."}}
401 missing_api_key | 401 invalid_api_key | 402 insufficient_credits
403 plan_required | 404 not_found | 422 invalid_parameters | 429 rate_limit_exceeded