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. |
3. Check-in-Link erhalten
{
"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.