FestImpact APIv1

API Documentatie

Gebruik de FestImpact API om duurzaamheidsgegevens van je evenementen te integreren met externe systemen zoals afvalverwerkers, energieleveranciers en rapportagetools.

Authenticatie

Alle API-verzoeken vereisen authenticatie via een API key in de Authorization header.

Authorization: Bearer fi_jouw_api_key_hier

API keys worden beheerd in Instellingen → API Keys in het dashboard. Elke key heeft specifieke permissies die bepalen welke endpoints toegankelijk zijn.

Beschikbare permissies

Permissie	Beschrijving
`read:events`	Evenementen ophalen
`read:co2`	CO2-data ophalen
`read:waste`	Afvaldata ophalen
`write:waste`	Afvalregistraties aanmaken
`read:summary`	Volledige samenvatting ophalen
`write:energy`	Energiemetingen importeren

Base URL

https://jouw-domein.nl/api/v1

Rate Limiting

De API heeft een limiet van 100 verzoeken per minuut per API key. Bij overschrijding ontvang je een 429 Too Many Requests response.

Foutmeldingen

De API gebruikt standaard HTTP-statuscodes:

Code	Beschrijving
200	Succesvol
201	Succesvol aangemaakt
400	Ongeldige aanvraag
401	Niet geauthenticeerd (ongeldige API key)
403	Onvoldoende rechten
404	Niet gevonden
429	Te veel verzoeken
500	Interne serverfout

{
  "error": "Beschrijving van de fout"
}

Endpoints

Snel starten met cURL

# Lijst van evenementen ophalen
curl -X GET "https://jouw-domein.nl/api/v1/events" \
  -H "Authorization: Bearer fi_jouw_api_key"

# Afvalregistratie aanmaken
curl -X POST "https://jouw-domein.nl/api/v1/events/EVENT_ID/waste" \
  -H "Authorization: Bearer fi_jouw_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "streamType": "plastic",
    "volumeKg": 25,
    "isRecycled": true,
    "handler": "Renewi"
  }'

# Energiemetingen importeren
curl -X POST "https://jouw-domein.nl/api/v1/energy/import" \
  -H "Authorization: Bearer fi_jouw_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "sourceId": "SOURCE_ID",
    "readings": [
      {"timestamp": "2026-04-01T12:00:00Z", "kwhConsumed": 10.5, "peakKw": 25}
    ]
  }'