RecranetPMS
Home / API
Ontwikkelaars

API-documentatie

Toegang tot uw eigen data via REST-endpoints, OAuth 2.0-authenticatie en webhooks voor asynchrone events.

Authenticatie

Alle API-verzoeken vereisen een Authorization: Bearer <token> header. Tokens worden verstrekt via OAuth 2.0 client-credentials flow tegen https://api.recranetpms.com/oauth/token.

curl -X POST https://api.recranetpms.com/oauth/token \
  -d "grant_type=client_credentials" \
  -d "client_id=$CLIENT_ID" \
  -d "client_secret=$CLIENT_SECRET"

Rate limits

  • Starter: 60 verzoeken per minuut
  • Groei: 300 verzoeken per minuut
  • Onderneming: 1200 verzoeken per minuut of custom

Belangrijkste endpoints

  • GET /v1/accommodations — lijst uw accommodaties
  • GET /v1/bookings — reserveringen ophalen
  • POST /v1/bookings — reservering aanmaken
  • PUT /v1/rates — tarieven pushen
  • GET /v1/guests/:id — gastgegevens ophalen
  • POST /v1/webhooks — webhook registreren
  • GET /v1/invoices — facturen downloaden

Webhooks

Registreer een HTTPS-endpoint om events te ontvangen: booking.created, booking.cancelled, payment.received, guest.registered. Payloads zijn ondertekend met HMAC-SHA256.

Volledige OpenAPI 3.1-specificatie beschikbaar op https://api.recranetpms.com/openapi.json. Postman-collectie op verzoek beschikbaar via support.