Production

Mederi Integration API

De canonieke integratielaag rond de Mederi-gegevens via één REST-contract en webhooks.

API referenceAan de slagopenapi.json
OmgevingProduction
API-versiev1
App-versie0.2.0
DatamodusLive
Base URLhttps://mia.e-mederi.be
Health/health

Aan de slag

1. Credentials

Je krijgt een client_id en client_secret van Mederi. Het secret wordt één keer getoond en is daarna niet meer op te vragen.

2. Token

Wissel je credentials om voor een access token via POST /oauth/token. Geldig één uur, geen refresh token.

3. Lezen

Stuur Authorization: Bearer … mee naar elk /v1-endpoint. Je scopes bepalen wat je mag.

Resources

Practices

Beschikbaar

De canonieke praktijken, uit beide Mederi-bronnen. Identiteit is practice_id: de Teamleader-referentie, bewust geen UUID.

GET /v1/practices

Scope: practices:read

Vacancies

Beschikbaar

De canonieke vacatures, inclusief publicatiestatus, provincie, positie en dienstverband.

GET /v1/vacancies

Scope: vacancies:read

Candidates

Beschikbaar

Identity-only. Geen naam, geen e-mailadres, geen hash: dit register bevat geen persoonsgegevens.

GET /v1/candidates

Scope: candidates:read

Applications

Beschikbaar

Sollicitaties, met verwijzing naar Candidate, vacature en praktijk. Aanmaken kan met een Idempotency-Key.

GET /v1/applications

Scope: applications:read

Recruitment Cases

Beschikbaar

Technisch identity/link-register: één legacy dossier gekoppeld aan een Candidate en eventueel een Application. Geen workflow.

GET /v1/recruitment-cases

Scope: recruitment-cases:read

Placement

Planned

Nog niet beschikbaar. Er is geen endpoint, geen schema en geen event voor Placement. Dit staat hier zodat duidelijk is dat het bewust ontbreekt en niet vergeten is.

Verder lezen

Authentication

OAuth2 client credentials, scopes en foutcodes.

Webhooks

Eventcatalogus, signatuur en retrybeleid.

Sandbox

Integreren zonder productiegegevens aan te raken.

API reference

Alle endpoints, met "Try it out".

OpenAPI

De machineleesbare specificatie (3.1).

Status

Health van deze installatie.

Code examples

Token opvragen (curl)
curl -X POST "https://mia.e-mederi.be/oauth/token" \
  -u "YOUR_CLIENT_ID:YOUR_CLIENT_SECRET" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials" \
  -d "scope=practices:read vacancies:read"
Praktijken lezen (curl)
curl "https://mia.e-mederi.be/v1/practices?page=1&per_page=25" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Accept: application/json"
Mederibox datawarehouse. M.I.A. leest de bronsystemen read-only. Een webhook is een notificatie, geen datalevering: haal de actuele toestand altijd op bij het endpoint.