API & Webhooks

ANLEITUNG: Buchungs-API, Buchungen aus Ihrer Software erstellen

Von: Diego Betancor, CTO · Informatikingenieur und Betriebswirt

Mit der Buchungs-API erstellen Sie eine Buchung in einer Ihrer Unterkünfte und erhalten sofort den Check-in-Link des Gastes. Um zu erfahren, wann er die Registrierung abschließt, richten Sie Webhooks ein.

1. API-Schlüssel erzeugen

Öffnen Sie Integrationen → API und erstellen Sie Ihren Schlüssel. Senden Sie ihn bei jeder Anfrage im Header Authorization als Bearer.

2. Buchung erstellen

curl -X POST https://app.registroparteviajeros.com/reservas \
  -H "Authorization: Bearer $RPV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "property_id": "prop_xxxxxxxx",
    "reference": "HMABC123",
    "reservation_date": "2026-10-01",
    "check_in": "2026-11-10",
    "check_out": "2026-11-12"
  }'
Feld Pflicht Beschreibung
property_id Ja Kennung der Unterkunft (prop_…), im Dashboard sichtbar.
reference Nein Referenz Ihres Systems. Pro Unterkunft eindeutig.
reservation_date Ja Buchungsdatum (YYYY-MM-DD).
check_in Ja Anreisedatum (YYYY-MM-DD).
check_out Ja Abreisedatum, mindestens eine Nacht später.
guest Nein Gästedaten: name, surname, email, phone, number_of_guests.
send_to_guest Nein Mit true senden wir den Check-in-Link per E-Mail an den Gast (erfordert guest.email).
payment_method Nein Standard PLATF (Plattformbuchung). Bei anderen Zahlungsarten sind die Gästedaten Pflicht.
{
  "id": "0192f3a4-…",
  "status": "created",
  "property_id": "prop_xxxxxxxx",
  "reference": "HMABC123",
  "checkin_code": "AbCd1234",
  "checkin_url": "https://app.registroparteviajeros.com/checkin/AbCd1234",
  "send_to_guest": false
}

checkin_url funktioniert ab diesem Moment: Senden Sie ihn dem Gast über Ihren bevorzugten Kanal oder aktivieren Sie send_to_guest.

Häufige Fehler

Code Bedeutung
400 Ungültige Daten. Die Antwort nennt das zu korrigierende Feld.
401 API-Schlüssel fehlt oder ist ungültig.
403 Die Unterkunft existiert nicht oder gehört nicht zu Ihrem Konto.
409 Eine Buchung mit dieser reference existiert in der Unterkunft bereits.
429 Zu viele Anfragen hintereinander: Warten Sie einige Sekunden und versuchen Sie es erneut.

Nächster Schritt

Richten Sie Webhooks ein, damit Ihr System benachrichtigt wird, wenn der Gast die Registrierung abschließt.