DPP API Endpoints Overzicht Bijgewerkt 18 mei 2026 · 10 wijzigingen Inventaris van alle endpoints voor depubliekepartner.nl infrastructuur.
Inhoudsopgave
TESS Platform
AI Infrastructuur
Interne Tools
Data Ingestie
Externe Services
Automatisering
Subdomain Migratie
Environment Variables
Snelnavigatie
1. TESS Platform
Centraal recruitment en kandidatenbeheer platform.
1.1 TESS Applicatie
Overzicht
TESS is het hart van de DPP operatie. Het platform biedt kandidaatbeheer, opdracht matching, dossierbeheer, en integraties met externe systemen. Het systeem ondersteunt de volledige recruitment lifecycle van intake tot plaatsing.
Service Details
Veld Waarde Production URL app.depubliekepartner.nl Preview/Dev URL *.tesst.depubliekepartner.nlAuthenticatie Supabase Auth (magic link, Google OAuth) Repository depubliekepartner/tess Hosting Vercel Database Supabase (PostgreSQL + pgvector) Framework Next.js 14, TypeScript, Tailwind CSS, shadcn/ui
Modules
Module Beschrijving Gebruikers Status Backoffice Aanbiedingen, compliance, dossierbeheer, matching Interne medewerkers Production Kandidaat Portal Opdrachten bekijken, reageren, profiel, documenten Kandidaten Production E-mail Gmail OAuth, inbox management, templates Interne medewerkers In Development Agenda Google Calendar sync, afspraken, interviews Alle gebruikers In Development
Rollen & Rechten (RBAC)
Rol Beschrijving Toegang Super Admin Systeemeigenaar Alles, incl. systeemintegraties Admin Dagelijks beheer Kandidaten, opdrachten, leveranciers Backoffice Uitvoering Dossiers, checks, contracten Frontoffice Eerstelijns Kandidatenlijst, chat, telefoonnotities
Technische Architectuur
┌─────────────────────────────────────────────────────────────────┐
│ Next.js App Router (Vercel) │
│ Backoffice │ Kandidaat Portal │ E-mail │ Agenda │
└─────────────────────────────────────────────────────────────────┘
│
┌────────────────┼────────────────┐
▼ ▼ ▼
┌───────────┐ ┌───────────┐ ┌───────────┐
│ Supabase │ │ Google │ │ AI Router │
│ Auth/DB │ │ OAuth/API │ │ Matching │
└───────────┘ └───────────┘ └───────────┘
Active Branches
Branch Feature Status mainProduction Stable feat/backoffice-urenregistratieUrenregistratie module In Development feature/latestbramFeature development Active
1.2 Urenregistratie (Planned)
Overzicht
Maandelijkse urenregistratie voor geplaatste kandidaten. Onderdeel van de TESS backoffice, met workflow voor indiening en goedkeuring.
Status
Fase Progress Dossier opbouw 90% Contracten 30% Urenregistratie 0% (blocked by Contracten) Facturatie 0% Uitbetalingen 0%
Database Schema (Planned)
Table: urenstaten
Column Type Beschrijving idUUID Primary key aanbieding_idUUID FK naar aanbiedingen user_idUUID FK naar auth.users jaarINT Jaar maandINT Maand (1-12) statusTEXT concept / ingediend / goedgekeurd / afgekeurd totaal_urenDECIMAL Totaal uren (denormalized)
Table: uren_entries
Column Type Beschrijving idUUID Primary key urenstaat_idUUID FK naar urenstaten datumDATE Werkdatum urenDECIMAL Aantal uren (0-24) omschrijvingTEXT Optionele toelichting
2. AI Infrastructuur
LLM proxies, routing, en AI-powered integraties.
2.1 LLM Proxy (CLIProxyAPI)
Overzicht
Self-hosted OpenAI-compatible proxy voor Claude en GPT modellen. Draait lokaal en is bereikbaar via Cloudflare Tunnel. Primair gebruikt voor CLI tools en development.
Service Details
API Endpoints
Method Path Beschrijving Request Body POST/v1/chat/completionsChat completions (streaming) { model, messages, stream?, temperature? }GET/v1/modelsLijst beschikbare modellen -
Beschikbare Modellen
Model ID Provider Beschrijving Context claude-opus-4-5Anthropic Meest capabele Claude 200K tokens claude-sonnet-4-5Anthropic Gebalanceerd Claude 200K tokens claude-haiku-4-5Anthropic Snelste Claude 200K tokens gpt-5.2-codex-xhighOpenAI Premium GPT 128K tokens gpt-5.2-codexOpenAI Standaard GPT 128K tokens
Voorbeeld
curl -X POST https://llm.depubliekepartner.nl/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"claude-sonnet-4-5","messages":[{"role":"user","content":"Hello"}]}'
2.2 AI Router
Overzicht
Intelligente multi-provider routing met automatische failover, RAG, audio transcriptie, en structured output. Centrale AI gateway voor alle DPP applicaties.
Service Details
Core Endpoints
Method Path Beschrijving Request Body POST/v1/chat/completionsChat completions { model, messages, stream? }POST/v1/embeddingsText embeddings { model, input }POST/v1/promptLegacy prompt { prompt, model? }GET/v1/modelsLijst modellen - POST/v1/routes/:groupRoute groups (moa, frontier) { messages }POST/v1/parseStructured output { messages, schema }
Audio Endpoints
Method Path Beschrijving Request Body POST/v1/audio/transcriptionsWhisper transcriptie multipart: file, model?, language?POST/v1/audio/translationsVertaling naar Engels multipart: file, model?
RAG Endpoints
Method Path Beschrijving Request Body POST/v1/documentsUpload document multipart: file, collection?GET/v1/documentsLijst documenten - DELETE/v1/documents/:idVerwijder document - POST/v1/retrieveSemantic search { query, collection?, limit? }GET/v1/collectionsLijst collecties -
Admin Endpoints
Method Path Beschrijving GET/admin/meHuidige gebruiker */admin/providersBeheer providers */admin/modelsBeheer modellen */admin/keysBeheer API keys */admin/routesBeheer routing GET/admin/statsGebruik statistieken GET/admin/logsRequest logs
Features
Multi-provider failover: Automatische switch bij errors
Request logging: Audit trail van alle requests
Rate limiting: Per-key rate limits
Cost tracking: Kosten per request/key
Model aliasing: Custom model namen
2.3 Flowlu MCP Server
Overzicht
Model Context Protocol (MCP) server voor directe Flowlu CRM toegang vanuit AI assistenten. Ondersteunt multi-user authenticatie met per-user credentials.
Service Details
Beschikbare Tools
Tool Beschrijving flowlu_statusCheck API connectie flowlu_list_accountsLijst CRM accounts flowlu_get_accountHaal account details flowlu_create_accountMaak nieuw account flowlu_list_contactsLijst contactpersonen flowlu_create_contactMaak contact flowlu_list_opportunitiesLijst opportunities flowlu_create_opportunityMaak opportunity flowlu_list_pipelinesLijst pipelines flowlu_list_stagesLijst pipeline stages flowlu_list_tasksLijst taken flowlu_create_taskMaak taak flowlu_complete_taskVoltooi taak flowlu_list_projectsLijst projecten flowlu_create_projectMaak project flowlu_list_usersLijst gebruikers
Active Branches
Branch Feature mainProduction feat/internal-org-flowlu-credsInternal org credential management
3. Interne Tools
Dashboards, knowledge base, en communicatie.
3.1 Cockpit
Overzicht
Management dashboard met real-time statistieken, AI-powered kandidaat matching, en chat interface voor data queries. Integreert met TESS database en Flowlu CRM.
Service Details
Features
Feature Beschrijving Dashboard Real-time stats: kandidaten, opdrachten, conversies Opdrachten Browse/search DAS opdrachten, filters per provincie/status Kandidaten Profielen met CV parsing, skill extraction AI Matching Hybrid scoring: semantic (35%), title (25%), skills (20%), role (15%), seniority (5%) Chat AI assistant met tool calling voor DB queries
API Endpoints
Method Path Beschrijving GET/api/statsDashboard statistieken POST/api/matchAI matching POST/api/chatStreaming chat GET/api/kandidatenLijst kandidaten GET/api/top-matchesTop matches
Active Branches
Branch Feature mainProduction feat/kbKB integration fix/supabase-key-dashboard-layoutDashboard fix
3.2 Knowledge Base
Overzicht
Interne kennisbank voor engineering documentatie, procedures, en technische specificaties. Dit document is onderdeel van de KB.
Service Details
API Endpoints
Method Path Beschrijving GET/api/docsLijst/haal documenten PUT/api/docsUpdate document POST/api/kbVector search GET/POST/api/commentsDoc comments GET/api/meHuidige gebruiker
Content Sections
Section Path Beschrijving Handboek /docs/handboek/Engineering procedures en standaarden Techniek /docs/handboek/techniek/Technische documentatie Agile /docs/handboek/agile/Agile werkwijze en sprints Flowlu /docs/flowlu/Flowlu CRM standaarden TESS /docs/tess/TESS platform documentatie Beheer /docs/beheer/KB beheer richtlijnen
3.3 CometChat Integration
Overzicht
Real-time chat voor het TESS platform. Vervangt eerdere Slack integratie met CometChat SDK voor betrouwbare messaging.
Service Details
Environment Variables
Variable Beschrijving VITE_COMETCHAT_APP_IDCometChat App ID VITE_COMETCHAT_AUTH_KEYCometChat Auth Key VITE_COMETCHAT_REGIONRegion (default: eu)
Features
Feature Beschrijving Conversations 1-on-1 en groepsgesprekken Message History Volledige chat geschiedenis User Presence Online/offline indicators Group Chats Team channels Real-time Instant delivery Typing Indicators Live typing status Read Receipts Leesbevestigingen
Active Branches
Branch Feature Status mainBase setup Stable feat/cometchat-integrationCometChat implementation Active auto/revamp-ui-ux-tess-styc05UI/UX improvements Active
4. Data Ingestie
Scrapers, feeds, en externe data bronnen.
4.1 TenderNed API
Overzicht
Nederlandse overheidsaanbestedingen. Monitort relevante tenders voor matching met kandidaten. Dagelijkse sync van nieuwe publicaties.
Service Details
API Endpoints
Method Path Beschrijving GET/publicatiesLijst aanbestedingen GET/publicaties/{id}/public-xmlTender details (XML)
Query Parameters
Parameter Beschrijving Waarden typeOpdrachtType opdracht D (Diensten), W (Werken), L (Leveringen) publicatieTypeType publicatie AAO, AGO, MAC publicatieDatumVanafVanaf datum ISO date sluitingsDatumVanafSluiting vanaf ISO date europeesEU aanbestedingen true/false
4.2 YACHT Feed
Overzicht
Automatische verwerking van YACHT job feed. Webhook-triggered bij nieuwe opdrachten, verrijkt met AI voor skill extraction.
Service Details
Workflow
Webhook ontvangt YACHT data
Filter op status 2 (nieuwe opdrachten)
AI verrijking (skill extraction, categorisatie)
Opslaan in Supabase job tabel
Notificatie naar backoffice
4.3 STRIIVE Feed
Overzicht
Verwerking van STRIIVE job data met AI-powered enrichment.
Service Details
4.4 Voys Recordings
Overzicht
Automatische sync van Voys telefoonopnames. Cron-based ophalen, opslag in R2, metadata in database voor zoeken.
Service Details
API Endpoints
Method Path Beschrijving GET/healthHealth check GET/syncManual sync trigger GET/recordingsLijst opnames POST/webhookVoys webhook
5. Externe Services
Third-party services en APIs.
5.1 Flowlu CRM
Overzicht
CRM en project management. Sales pipeline, klantbeheer, en agile boards voor engineering.
Service Details
Agile Endpoints
Method Path Beschrijving GET/module/agile/issues/listLijst issues POST/module/agile/issues/createMaak issue PUT/module/agile/issues/updateUpdate issue GET/module/agile/sprints/listLijst sprints GET/module/agile/boards/listLijst boards
CRM Endpoints
Method Path Beschrijving GET/crm/account/listAccounts GET/crm/contact/listContacts GET/crm/lead/listOpportunities GET/crm/pipeline/listPipelines
Reference IDs
Type ID Value Stage 8 Backlog Stage 11 In Progress Stage 13 Done Issue Type 1 Task Issue Type 2 Bug Issue Type 3 Story Priority 30 High Priority 40 Medium
5.2 Supabase
Overzicht
Backend-as-a-Service. Primaire database voor TESS en andere applicaties. PostgreSQL met pgvector voor semantic search.
Service Details
Database Tables
Table Beschrijving jobOpdrachten en vacatures platformExterne job platforms headquartersHoofdkantoor locaties work_locationWerklocaties contract_typeContract types job_documentOpdracht documenten kandidatenKandidaat profielen aanbiedingenAanbiedingen aan kandidaten urenstatenUrenregistratie (planned) kb_doc_commentsKB commentaren
Features
Feature Beschrijving PostgreSQL SQL + pgvector Auth Magic links, OAuth, JWT Storage File storage Realtime WebSocket subscriptions Edge Functions Serverless (Deno)
5.3 Google APIs
Overzicht
Authenticatie, email, agenda, en document integraties.
Service Details
API Scopes
6. Automatisering
Workflow automation en batch processing.
6.1 Activepieces Flows
Overzicht
Workflow automation platform. Integreert systemen via webhooks, cron triggers, en AI processing.
Service Details
Flow Categorieën
Folder Beschrijving ai-router/AI Router test suite recruitment/CV verwerking, feeds content/Content generatie queue/Queue-based processing yacht/YACHT integratie templates/Herbruikbare templates
Active Flows
ID Naam Trigger Beschrijving 0004 QUEUE JOBPOST Cron Batch job posts verwerking 0013 YACHT Webhook YACHT feed processing 0014 STRIIVE Webhook STRIIVE data met AI 0460 CV Verwerking Webhook CV + motivatie parsing 0500 CV Data Extract Webhook Structured data extraction - Blogpost Schedule SEO blog generatie - AI Router Test Webhook API test suite
Key Integrations
Service Gebruik Straico AI processing (Claude, GPT) AI Router Internal AI proxy Flowlu CRM data Google Sheets Data storage, config Google Drive Document storage
6.2 CV Verwerking
Overzicht
Automatische CV parsing en kandidaat aanmaak. Extracteert gestructureerde data voor matching.
Workflow
CV Upload (Webhook)
│
▼
┌─────────────────┐
│ Document Parse │ ← PDF/DOCX extraction
└────────┬────────┘
│
▼
┌─────────────────┐
│ AI Extraction │ ← Skills, ervaring, opleiding
└────────┬────────┘
│
▼
┌─────────────────┐
│ Data Mapping │ ← Structured kandidaat record
└────────┬────────┘
│
▼
┌─────────────────┐
│ Supabase Insert │ ← kandidaten tabel
└─────────────────┘
Extracted Fields
Veld Beschrijving naamVolledige naam emailContact email telefoonTelefoonnummer skillsArray van vaardigheden ervaringWerkervaring (jaren, bedrijven) opleidingOpleidingsachtergrond beschikbaarheidStartdatum, uren tariefindicatieUurtarief range
7. Subdomain Migratie
Overzicht van endpoints die nog gemigreerd moeten worden naar depubliekepartner.nl subdomeinen.
Huidige Status
Status Beschrijving Migrated Draait op *.depubliekepartner.nl Interim Tijdelijk domein, migratie gepland Pending Cloudflare/extern domein, migratie nodig External Third-party service, geen migratie mogelijk
Migratie Inventaris
Service Huidig Target Status Prioriteit TESS app.depubliekepartner.nl- Migrated - TESS Preview *.tesst.depubliekepartner.nl- Migrated - LLM Proxy llm.depubliekepartner.nl- Migrated - LLM Proxy llm.dppapi.nlllm.depubliekepartner.nlInterim Low AI Router router.dpp-ai.workers.devrouter.depubliekepartner.nlPending High AI Router Admin ai-router-admin.pages.devrouter-admin.depubliekepartner.nlPending Medium Cockpit dpp-cockpit.pages.devcockpit.depubliekepartner.nlPending High Knowledge Base home.dpp-kb.pages.devkb.depubliekepartner.nlPending High Flowlu MCP flowlu-mcp.icy-breeze-c97d.workers.devflowlu-mcp.depubliekepartner.nlPending Medium Voys Recordings voys-recordings.dpp-ai.workers.devvoys.depubliekepartner.nlPending Low CometChat TBD (Cloudflare Pages) chat.depubliekepartner.nlPending Medium Flowlu CRM depubliekepartner.flowlu.com- External - Supabase Supabase hosted - External - TenderNed tenderned.nl- External -
Migratie Stappen
Per service:
DNS configuratie - CNAME record toevoegen in Cloudflare DNS
Custom domain - Toevoegen in Cloudflare Pages/Workers dashboard
SSL certificaat - Automatisch via Cloudflare (of handmatig indien nodig)
Testen - Verificatie van nieuwe URL
Redirect - Oude URL redirecten naar nieuwe (301)
Documentatie - URLs updaten in KB en code
Cloudflare DNS Records (Nodig)
router.depubliekepartner.nl CNAME router.dpp-ai.workers.dev
router-admin.depubliekepartner.nl CNAME ai-router-admin.pages.dev
cockpit.depubliekepartner.nl CNAME dpp-cockpit.pages.dev
kb.depubliekepartner.nl CNAME home.dpp-kb.pages.dev
flowlu-mcp.depubliekepartner.nl CNAME flowlu-mcp.icy-breeze-c97d.workers.dev
voys.depubliekepartner.nl CNAME voys-recordings.dpp-ai.workers.dev
chat.depubliekepartner.nl CNAME [TBD].pages.dev
8. Environment Variables
Overzicht van benodigde environment variables.
Variable Service Beschrijving FLOWLU_API_KEYFlowlu Flowlu API key GH_TOKENGitHub Personal Access Token SB_KEYSupabase Service Role Key SB_URLSupabase Project URL PROXY_API_KEYAI Router Router API Key G_CLI_IDGoogle OAuth Client ID G_CLI_SECGoogle OAuth Client Secret SESS_SECSessions Encryption secret VOYS_API_KEYVoys Voys API key TENDERNED_USERTenderNed Basic Auth user TENDERNED_PASSTenderNed Basic Auth pass VITE_COMETCHAT_APP_IDCometChat App ID VITE_COMETCHAT_AUTH_KEYCometChat Auth Key
Gerelateerde Documentatie
Laatste update: 2026-01-30