Con la API de reservas creas una reserva en una de tus propiedades y obtienes al instante el enlace de check-in del huésped. Si quieres saber cuándo completan el registro, configura los webhooks.
1. Genera tu API key
Entra en Integraciones → API y crea tu clave. Envíala en cada petición en la cabecera Authorization como Bearer.
2. Crea la reserva
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"
}'
| Campo | Obligatorio | Descripción |
|---|---|---|
property_id |
Sí | Identificador de la propiedad (prop_…), visible en el panel. |
reference |
No | Referencia de tu sistema. Única por propiedad. |
reservation_date |
Sí | Fecha de la reserva (YYYY-MM-DD). |
check_in |
Sí | Fecha de entrada (YYYY-MM-DD). |
check_out |
Sí | Fecha de salida, al menos una noche después. |
guest |
No | Datos del huésped: name, surname, email, phone, number_of_guests. |
send_to_guest |
No | Con true, enviamos el enlace de check-in al correo del huésped (requiere guest.email). |
payment_method |
No | Por defecto PLATF (reserva de plataforma). Con otros medios de pago, los datos del huésped son obligatorios. |
3. Recibe el enlace de check-in
{
"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 funciona desde ese momento: envíalo al huésped por el canal que prefieras o activa send_to_guest.
Errores habituales
| Código | Significado |
|---|---|
400 |
Datos no válidos. La respuesta indica qué campo corregir. |
401 |
Falta la API key o no es válida. |
403 |
La propiedad no existe o no pertenece a tu cuenta. |
409 |
Ya existe una reserva con esa reference en la propiedad. |
429 |
Demasiadas peticiones seguidas: espera unos segundos y reintenta. |
Siguiente paso
Configura los webhooks para que tu sistema reciba el aviso cuando el huésped termine el registro.