triqura-ecd/docs/specs/archive/api-acces-mini-ecd.md at main

Files

colinislit f8904db3e9 fix: resolve MDX type imports for release notes

Fixed runtime error in release notes pages:
- Removed unused MDXRemote import from lib/mdx/releases.ts
- Fixed MDXComponents type import in mdx-components.tsx
- Added @types/mdx as dev dependency

Pages now load correctly:
- /releases (overview)
- /releases/authentication
- /releases/release-notes-system

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

2025-11-19 21:16:45 +01:00

2.5 KiB

Raw Permalink Blame History

API‑toegang Mini‑ECD

Laatste update: 2025‑11‑09 • Versie: 0.2 (MVP)

Overzicht

De Mini‑ECD API biedt server‑side endpoints in Next.js voor AI‑functionaliteit (Claude / Anthropic). In de MVP is één endpoint beschikbaar.

Base URL

Ontwikkel (lokaal): http://localhost:3000
Productie: n.t.b. (Vercel)

Authenticatie

MVP: geen externe client‑auth; endpoints dienen alleen in trusted context gebruikt te worden (server‑side calls of demo‑omgeving).
Claude AI authenticatie verloopt server‑side via Anthropic API key.

Headers

Content-Type: application/json

Endpoints

POST `/api/ai/summarize`

Doel: vat NL intake‑tekst samen in puntsgewijze bullets (max 6), neutraal en feitelijk.
Request body

{
  "text": "string (1..20000)",
  "language": "string (optioneel, default: nl)"
}

Voorbeeld (PowerShell)

Invoke-RestMethod -Uri http://localhost:3000/api/ai/summarize -Method POST -Body (@{ text = "Korte intake tekst" } | ConvertTo-Json) -ContentType "application/json"

Voorbeeld (curl)

curl -X POST http://localhost:3000/api/ai/summarize \
  -H "Content-Type: application/json" \
  -d '{"text":"Korte intake tekst"}'

Response (200)

{
  "summary": "- Bullet 1\n- Bullet 2\n..."
}

Fouten
- 400: ongeldige body (validatie faalt)
- 500: Claude AI fout of configuratie ontbreekt

Omgevingsvariabelen

Claude AI
- ANTHROPIC_API_KEY (bv. sk-ant-...) — vereist voor alle AI-endpoints
Optioneel
- ANTHROPIC_MODEL (default claude-3-5-sonnet-20241022)

Voorbeeld in .env.local (lokaal): zie /.env.example.

Implementatiedetails

Server helper: src/lib/server/claude.ts initialiseert Claude client met API key.
Endpoint: src/app/api/ai/summarize/route.ts (Next.js Route Handler met Zod‑validatie, Claude API call).

Beveiliging (MVP)

Houd ANTHROPIC_API_KEY uit de client; uitsluitend server‑side gebruiken.
Gebruik Vercel Environment Variables in productie.

Roadmap (volgende endpoints)

POST /api/ai/readability – herschrijf naar B1‑niveau.
POST /api/ai/extract – extracteer categorie/severity uit intake.
POST /api/ai/generate-plan – genereer behandelplan (Doelen, Interventies, etc.).

Changelog

0.2 (2025‑11‑09): Migratie naar Next.js + Claude AI (Anthropic); update van base URL naar :3000.
0.1 (2025‑09‑02): Eerste versie met summarize endpoint en env‑richtlijnen.

2.5 KiB Raw Permalink Blame History Unescape Escape