Aanleveren via de Partner-API

Introductie

De Partner-API biedt organisaties, evenementenorganisatoren en nieuwsredacties een simpele manier om content rechtstreeks aan te leveren. Gebruik de API om evenementen en nieuws te sturen zodat lokale bewoners het snel zien. De API is bedoeld om content veilig en gestructureerd aan te leveren — we controleren korte inhoudsregels en publiceren relevante items.

Hoe werkt het? (stappenplan)

1
Registreren
Meld je organisatie aan via het partnerformulier om toegang aan te vragen.
2
API-sleutel ontvangen
Na goedkeuring ontvang je een persoonlijke X-Partner-Key die je gebruikt bij elk verzoek.
3
Content insturen
Stuur evenementen of nieuws via de API-endpoints met de vereiste velden.
4
Beoordeling
Onze redactie controleert of de inzending aan de richtlijnen voldoet en geschikt is voor publicatie.
5
Publicatie
Bij goedkeuring wordt de content gepubliceerd en zichtbaar voor gebruikers.

Wat wil je aanleveren?

Kies hieronder of je een evenement of een nieuwsbericht wilt aanleveren. De relevante instructies verschijnen vervolgens.

Evenementen en nieuws hebben ieder hun eigen velden en voorbeelden. Kies één van de opties om de instructies uit te klappen.

Evenement insturen

Endpoint: POST /partner/events
Header: X-Partner-Key: <jouw-sleutel>

Verplichte velden

titel — string
beschrijving — string (min. 30 tekens)
startDatum — ISO 8601 (bv. 2026-06-12T19:00:00+02:00)
stad — Nederlandse gemeente

Optionele velden

eindDatum, locatie, categorie
websiteUrl, afbeeldingUrl

Werkend cURL-voorbeeld

curl -X POST "https://api.buurtapp.example/partner/events" \
  -H "Content-Type: application/json" \
  -H "X-Partner-Key: YOUR_PARTNER_KEY" \
  -d '{
    "titel": "Buurtconcert in Park Rijn",
    "beschrijving": "Kom genieten van een gratis buurtconcert met lokale artiesten. Neem een kleedje en vrienden mee!",
    "startDatum": "2026-06-12T19:00:00+02:00",
    "stad": "Leiden",
    "locatie": "Park Rijn, hoofdingang",
    "categorie": "Muziek",
    "websiteUrl": "https://voorbeeld.nl/evenement",
    "afbeeldingUrl": "https://cdn.voorbeeld.nl/images/concert.jpg"
  }'

Werkend JavaScript (fetch)

fetch('https://api.buurtapp.example/partner/events', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-Partner-Key': 'YOUR_PARTNER_KEY'
  },
  body: JSON.stringify({
    titel: 'Buurtconcert in Park Rijn',
    beschrijving: 'Kom genieten van een gratis buurtconcert met lokale artiesten. Neem een kleedje en vrienden mee!',
    startDatum: '2026-06-12T19:00:00+02:00',
    stad: 'Leiden'
  })
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(err => console.error(err));

Nieuws insturen

Endpoint: POST /partner/news
Header: X-Partner-Key: <jouw-sleutel>

Verplichte velden

titel — string
samenvatting — string (min. 20 tekens)
url — volledige URL (https://...)
gepubliceerdOp — ISO 8601

Optionele velden

stad, categorie, afbeeldingUrl

Werkend cURL-voorbeeld

curl -X POST "https://api.buurtapp.example/partner/news" \
  -H "Content-Type: application/json" \
  -H "X-Partner-Key: YOUR_PARTNER_KEY" \
  -d '{
    "titel": "Nieuwe speeltuin geopend in Oude Dorp",
    "samenvatting": "Een veilige en groene speeltuin voor alle leeftijden is vandaag officieel geopend.",
    "url": "https://nieuwsorganisatie.nl/nieuws/speeltuin-geopend",
    "gepubliceerdOp": "2026-04-25T10:30:00+02:00",
    "stad": "Amersfoort",
    "categorie": "Lokale Nieuws",
    "afbeeldingUrl": "https://cdn.nieuwsorganisatie.nl/images/speeltuin.jpg"
  }'

Status van je inzending opvragen

Endpoint: GET /partner/submissions/{submissionId}
Header: X-Partner-Key: <jouw-sleutel>

Voorbeeldresponse

curl -X GET "https://api.buurtapp.example/partner/submissions/abc123" -H "X-Partner-Key: YOUR_PARTNER_KEY"

fetch('https://api.buurtapp.example/partner/submissions/abc123',{headers:{'X-Partner-Key':'YOUR_PARTNER_KEY'}})

Mogelijke statuswaarden

pending: Je inzending is ontvangen en wordt beoordeeld.
approved: De inzending voldoet aan de richtlijnen en wordt klaargemaakt voor publicatie.
rejected: De inzending is afgewezen (er wordt kort uitgelegd waarom in het veld opmerkingen).
published: De inzending is gepubliceerd en zichtbaar voor gebruikers.

Foutcodes

Hieronder zie je veelvoorkomende HTTP-statuscodes en wat ze betekenen voor jouw inzending.

Status	Wat het betekent
400	Ongeldige invoer — controleer of alle verplichte velden aanwezig en juist geformatteerd zijn.
401	Ongeldige API-sleutel — controleer je X-Partner-Key en deel deze niet.
429	Te veel verzoeken — je doet te veel aanvragen in korte tijd; probeer later opnieuw.
500	Serverfout — er is iets mis bij onze kant; probeer het later nog eens.

Spelregels

Geen spam of herhaalde, overbodige inzendingen.
Geen misleidende of onjuiste informatie; wees eerlijk en controleer feiten.
Geen commerciële reclame zonder redactionele waarde of context.
Deel je API-sleutel niet met derden; houd die veilig.
Misbruik kan leiden tot intrekking van je API-sleutel.

Aanmelden als partner

Klaar om te starten? Meld je aan via ons registratieformulier en ontvang je persoonlijke API-sleutel.

Naar registratieformulier