Content aanleveren als partner
Of je nu zelf aan de knoppen wilt zitten of alles automatisch wilt koppelen, je kiest de manier die bij jouw organisatie past.
Hoe wil je aanleveren?
Kies de methode die het beste bij jouw organisatie past. Je kunt altijd wisselen.
Aanleveren via het partnerportaal
Geen technische kennis nodig. Vul een formulier in, klik op verzenden, en onze redactie doet de rest.
Dit heb je nodig
- Titel
- Samenvatting (jouw omschrijving)
- Bron (bijv. naam van je organisatie)
- Provincie(s): maximaal 3
- Optioneel: url, categorie, publicatiedatum, afbeelding
- Titel
- Beschrijving
- Bron (bijv. naam van je organisatie)
- Stad en provincie
- Startdatum
- Optioneel: einddatum, locatie, url, categorie, afbeelding
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.
Welke tools kun je gebruiken?
Je hoeft geen programmeur te zijn. Hieronder zie je drie manieren om de API te gebruiken, kies wat bij jou past.
- Open Terminal (Mac/Linux) of Git Bash (Windows)
- Kopieer een voorbeeld hieronder
- Plak en druk Enter: klaar
- Maak een nieuw Request aan
- Stel methode in op POST en voer de URL in
- Ga naar Headers → voeg X-Api-Key toe
- Ga naar Body → kies raw → selecteer JSON
- Plak het JSON-voorbeeld en klik Send
- Gebruik de ingebouwde fetch() of een library als axios
- Zet je API-sleutel in de header X-Api-Key
- Bekijk de werkende fetch-voorbeelden verderop op deze pagina
Hoe werkt het? (stappenplan)
- 1RegistrerenMeld je organisatie aan via het partnerformulier om toegang aan te vragen.
- 2API-sleutel ontvangenNa goedkeuring ontvang je een persoonlijke X-Api-Key die je gebruikt bij elk verzoek.
- 3Content insturenStuur evenementen of nieuws via de API-endpoints met de vereiste velden.
- 4BeoordelingOnze redactie controleert of de inzending aan de richtlijnen voldoet en geschikt is voor publicatie.
- 5PublicatieBij 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 /api/v1/submissions
Header: X-Api-Key: <jouw-sleutel>
Verplichte velden
type: "evenement"title: string (3–200 tekens)summary: string (min. 10 tekens)source: bronvermeldingcity: Nederlandse gemeenteprovince: provincie (slug, bijv. "utrecht")event_date: datum (YYYY-MM-DD)
Optionele velden
end_date,location,categoryurl,image_url
Werkend cURL-voorbeeld
curl -X POST "https://partner.buurtapponline.nl/api/v1/submissions" \ -H "Content-Type: application/json" \ -H "X-Api-Key: YOUR_API_KEY" \ -d '{ "type": "evenement", "title": "Buurtconcert in Park Rijn", "summary": "Kom genieten van een gratis buurtconcert met lokale artiesten.", "source": "Parkbestuur Leiden", "city": "Leiden", "province": "zuid-holland", "event_date": "2026-06-12", "location": "Park Rijn, hoofdingang", "category": "Muziek", "url": "https://voorbeeld.nl/evenement", "image_url": "https://cdn.voorbeeld.nl/images/concert.jpg" }'
Werkend JavaScript (fetch)
// Evenement aanleveren via fetch fetch('https://partner.buurtapponline.nl/api/v1/submissions', { method: 'POST', headers: { 'Content-Type': 'application/json', 'X-Api-Key': 'YOUR_API_KEY' }, body: JSON.stringify({ type: 'evenement', title: 'Buurtconcert in Park Rijn', summary: 'Kom genieten van een gratis buurtconcert met lokale artiesten.', source: 'Parkbestuur Leiden', city: 'Leiden', province: 'zuid-holland', event_date: '2026-06-12' }) }) .then(response => response.json()) .then(data => console.log(data)) .catch(err => console.error(err));
Nieuws insturen
Endpoint: POST /api/v1/submissions
Header: X-Api-Key: <jouw-sleutel>
Verplichte velden
type: "nieuws"title: string (3–200 tekens)summary: string (min. 10 tekens)source: bronvermeldingprovinces: array van provincie-slugs (max 3, bijv. ["utrecht"])
Optionele velden
category,url,image_url,published_at
Werkend cURL-voorbeeld
curl -X POST "https://partner.buurtapponline.nl/api/v1/submissions" \ -H "Content-Type: application/json" \ -H "X-Api-Key: YOUR_API_KEY" \ -d '{ "type": "nieuws", "title": "Nieuwe speeltuin geopend in Oude Dorp", "summary": "Een veilige en groene speeltuin voor alle leeftijden is vandaag officieel geopend.", "source": "Gemeente Amersfoort", "provinces": ["utrecht"], "url": "https://nieuwsorganisatie.nl/nieuws/speeltuin-geopend", "published_at": "2026-04-25", "category": "Lokaal nieuws", "image_url": "https://cdn.nieuwsorganisatie.nl/images/speeltuin.jpg" }'
Status van je inzending opvragen
Bekijk de status van ingediende content via het Overzicht in het partnerportaal, of vraag deze op via de API:
curl -X GET "https://partner.buurtapponline.nl/api/submissions" -H "X-Api-Key: YOUR_API_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.
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-Api-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 toegang tot het partnerportaal.
Naar registratieformulier