REST API v1

Publiceer via onze API

Integreer uw vastgoedsoftware, CRM of makelaarssysteem met Parkeerplaats.nl. Publiceer en beheer parkeerplaatsen automatisch.

API-sleutel aanmakenAPI-documentatie

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. Kopieer, pas aan en je bent live.

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",
    "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",
        "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',
    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.

Authorization: Bearer pk_live_...

Rate limiting

Maximaal 100 requests per minuut per API-sleutel. Bij overschrijding ontvang je een 429 status.

X-RateLimit-LimitX-RateLimit-RemainingRetry-After

Endpoints

GET/api/v1/listings
POST/api/v1/listings
GET/api/v1/listings/{id}
PATCH/api/v1/listings/{id}
DEL/api/v1/listings/{id}
POST/api/v1/listings/{id}/images
DEL/api/v1/listings/{id}/images

Interactieve API-documentatie

Bekijk alle endpoints, schemas en probeer requests direct uit. Importeer de OpenAPI spec in Postman of genereer client-bibliotheken.

API-documentatie laden...

Klaar om te integreren?

Maak een API-sleutel aan in uw dashboard en publiceer uw eerste advertentie binnen minuten.

API-sleutel aanmakenNeem contact op