06: stap 8, tweede eigen tool SLO leerdoelen met sleutel (registreren, Basic auth, Accept-header); agent koppelt materiaal aan tussendoelen

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-20 22:33:46 +02:00
parent 825de93f79
commit 7936fee88d
34 changed files with 136 additions and 6 deletions
@@ -0,0 +1,48 @@
+{
+  "openapi": "3.0.1",
+  "info": {
+    "title": "SLO leerdoelen",
+    "description": "Zoekt in de curriculumdatabase van SLO (opendata.slo.nl): kerndoelen, tussendoelen, eindtermen en vakbegrippen. Vraagt een gratis sleutel aan op opendata.slo.nl; die gaat als Basic-authenticatie (e-mail:sleutel) mee in de header Authorization.",
+    "version": "1.0.0"
+  },
+  "servers": [
+    {
+      "url": "https://opendata.slo.nl"
+    }
+  ],
+  "paths": {
+    "/curriculum/2026/api/v1/search": {
+      "get": {
+        "operationId": "zoekLeerdoelen",
+        "summary": "Zoek kerndoelen, tussendoelen, eindtermen en vakbegrippen bij een onderwerp",
+        "description": "Zoekt op tekst in de curriculumdatabase van SLO. Gebruik één of twee kernbegrippen (bijvoorbeeld: voedselweb). Het antwoord is een JSON-lijst; per item staan @type (Doel, Kerndoel, SyllabusSpecifiekeEindterm, LdkVakbegrip), title (de formulering van het doel) en bron (bijvoorbeeld Tussendoel).",
+        "parameters": [
+          {
+            "name": "text",
+            "in": "query",
+            "required": true,
+            "description": "Zoekwoord of korte zoekterm, bijvoorbeeld: voedselweb",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "Accept",
+            "in": "header",
+            "required": true,
+            "description": "Altijd application/json, anders stuurt SLO een webpagina terug",
+            "schema": {
+              "type": "string",
+              "default": "application/json"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Lijst met doelen en begrippen als JSON"
+          }
+        }
+      }
+    }
+  }
+}