Publiceer via onze API
Integreer uw vastgoedsoftware, CRM of makelaarssysteem met Parkeerplaats.nl. Publiceer en beheer parkeerplaatsen automatisch.
Snel aan de slag
In drie stappen van API-sleutel naar gepubliceerde advertentie.
1. API-sleutel aanmaken
Ga naar Dashboard → API-sleutels en maak een nieuwe sleutel aan. Je krijgt deze één keer te zien.
2. Eerste request
Stuur een POST naar /api/v1/listings met uw API-sleutel als Bearer token.
3. Synchroniseer
Gebruik external_id voor upsert. Uw CRM-ID wordt gekoppeld aan de advertentie.
Code voorbeelden
Voorbeelden in de meest populaire talen. Zonder status wordt een nieuwe advertentie een concept (draft). Stuur status: "active" om te publiceren. Een volgende POST met dezelfde external_id wijzigt alleen de meegestuurde velden.
cURL
curl -X POST https://www.parkeerplaats.nl/api/v1/listings \
-H "Authorization: Bearer pk_live_xxxxxxxx..." \
-H "Content-Type: application/json" \
-d '{
"title": "Garagebox centrum Amsterdam",
"type": "garagebox",
"usage": "storage_only",
"contact_email": "boxen@example.com",
"transaction_type": "huur",
"price": 150,
"price_suffix": "p/mnd",
"city": "Amsterdam",
"postal_code": "1015AA",
"external_id": "CRM-12345"
}'Python
import requests
API_KEY = "pk_live_xxxxxxxx..."
BASE = "https://www.parkeerplaats.nl/api/v1"
resp = requests.post(
f"{BASE}/listings",
headers={"Authorization": f"Bearer {API_KEY}"},
json={
"title": "Garagebox centrum Amsterdam",
"type": "garagebox",
"usage": "storage_only",
"contact_email": "boxen@example.com",
"transaction_type": "huur",
"price": 150,
"price_suffix": "p/mnd",
"city": "Amsterdam",
"external_id": "CRM-12345",
},
)
print(resp.json())JavaScript / Node.js
const API_KEY = 'pk_live_xxxxxxxx...';
const BASE = 'https://www.parkeerplaats.nl/api/v1';
const res = await fetch(`${BASE}/listings`, {
method: 'POST',
headers: {
'Authorization': `Bearer ${API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
title: 'Garagebox centrum Amsterdam',
type: 'garagebox',
usage: 'storage_only',
contact_email: 'boxen@example.com',
transaction_type: 'huur',
price: 150,
price_suffix: 'p/mnd',
city: 'Amsterdam',
external_id: 'CRM-12345',
}),
});
console.log(await res.json());Authenticatie
Alle requests vereisen een API-sleutel als Bearer token in de Authorization header. Zet de sleutel nooit in publieke frontendcode. De API is bedoeld voor server-to-server.
Authorization: Bearer pk_live_...Rate limiting
Maximaal 100 requests per minuut per API-sleutel. Elke geauthenticeerde response bevat de headers hieronder. Bij overschrijding ontvang je 429 plus Retry-After.
Endpoints
/api/v1/listings/api/v1/leads/api/v1/listings/api/v1/listings/{id}/api/v1/listings/{id}/api/v1/listings/{id}/api/v1/listings/{id}/images/api/v1/listings/{id}/images/api/v1/listings/{id}/images/uploads/api/v1/listings/{id}/images/uploads/completeFoto's tot 10 MiB: vraag een signed URL via /images/uploads, upload het bestand daarheen, en rond af met /images/uploads/complete. De multipart-upload op /images gaat via de website-server en wordt door de hosting rond 4,5 MiB afgekapt.
Garageboxen en reacties
Bij een garagebox is usage verplicht. Kies parking (voertuig stallen), storage_only (alleen opslag, geen voertuigen) of both. Bij alleen opslag staat dat op de advertentie, en die advertentie komt niet tussen de resultaten voor wie een auto-plek zoekt.
Met hetzelfde external_id werkt een volgende POST de advertentie bij. Zet status op ingetrokken om haar meteen offline te halen. Zonder status blijft een nieuwe advertentie een concept.
Reacties (naam, e-mail, bericht) haal je op met GET /api/v1/leads. Daarin zit ook jullie external_id. Het bericht gaat tegelijk per e-mail naar contact_email van die advertentie, of anders naar het e-mailadres van het account. Een datum beschikbaar vanaf, lengte, breedte en hoogte in meters, en een borg stuur je mee als available_from, length, width, height en deposit. Elektra en verlichting zijn voorzieningen naast laadpaal, overdekt en camerabewaking. show_address: false verbergt het huisnummer. vat_exempt: true zet “vrijgesteld van btw” bij de huurprijs.
Er is geen directe huur of betaling.
Interactieve API-documentatie
Bekijk alle endpoints, schemas en probeer requests direct uit. Importeer de OpenAPI spec in Postman of genereer client-bibliotheken. Welke partijen de API en de reacties verwerken, staat op de pagina subverwerkers.
Klaar om te integreren?
Maak een API-sleutel aan in uw dashboard en publiceer uw eerste advertentie binnen minuten.