Provider API

Opdrachten, statussen en documenten

De Provider API gebruikt Bearer API keys uit het partnerportaal. De productie-base URL is https://sjel.nl/api/v1.

Swagger openen OpenAPI JSON API key beheren

Authenticatie

Bearer token

Stuur je key mee via de Authorization-header. API keys zijn gekoppeld aan je dienstprofiel en geven alleen toegang tot je eigen opdrachten.

Authorization: Bearer sjel_live_...

Voorbeeld

Opdrachten ophalen

curl https://sjel.nl/api/v1/provider/assignments \
  -H "Authorization: Bearer sjel_live_..."

GET

/provider/assignments

Toont de opdrachten die aan jouw dienstprofiel gekoppeld zijn.

POST

/provider/assignments/{id}/appointments

Stel een of meerdere afspraakmomenten voor aan de klant.

{
  "starts_at": [
    "2026-06-18T09:30:00+02:00",
    "2026-06-18T13:00:00+02:00"
  ],
  "duration_minutes": 60,
  "note": "Kies een moment dat het beste past."
}

POST

/provider/assignments/{id}/documents

Upload het resultaatdocument, zoals een energielabel of rapport.

curl https://sjel.nl/api/v1/provider/assignments/123/documents \
  -H "Authorization: Bearer sjel_live_..." \
  -F "[email protected]" \
  -F "note=Definitief label"

Afspraakmomenten

Velden en validatie

starts_at is verplicht en bevat 1 tot 5 toekomstige ISO 8601 datums met timezone. duration_minutes is optioneel en moet tussen 15 en 240 minuten liggen. note is optioneel.

Swagger

Interactief testen

Gebruik Swagger om alle request bodies, responses en authenticatie op één plek te bekijken.

Swagger reference openen

Sandbox

Testopdracht maken

In het partnerportaal kan een dienstverlener een sandbox-opdracht aanmaken. Daarmee kun je API-calls, afspraakmomenten, documentuploads en webhooks testen zonder echte klantbetaling.

Partnerportaal openen