Con l’API prenotazioni crei una prenotazione in una delle tue strutture e ottieni subito il link di check-in dell’ospite. Per sapere quando completa la registrazione, configura i webhook.
1. Genera la tua API key
Vai su Integrazioni → API e crea la tua chiave. Inviala in ogni richiesta nell’intestazione Authorization come Bearer.
2. Crea la prenotazione
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 | Obbligatorio | Descrizione |
|---|---|---|
property_id |
Sì | Identificativo della struttura (prop_…), visibile nel pannello. |
reference |
No | Riferimento del tuo sistema. Univoco per struttura. |
reservation_date |
Sì | Data della prenotazione (YYYY-MM-DD). |
check_in |
Sì | Data di arrivo (YYYY-MM-DD). |
check_out |
Sì | Data di partenza, almeno una notte dopo. |
guest |
No | Dati dell’ospite: name, surname, email, phone, number_of_guests. |
send_to_guest |
No | Con true, inviamo il link di check-in via e-mail all’ospite (richiede guest.email). |
payment_method |
No | Predefinito PLATF (prenotazione di piattaforma). Con altri metodi di pagamento i dati dell’ospite sono obbligatori. |
3. Ricevi il link di 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 funziona da quel momento: invialo all’ospite dal canale che preferisci o attiva send_to_guest.
Errori frequenti
| Codice | Significato |
|---|---|
400 |
Dati non validi. La risposta indica quale campo correggere. |
401 |
API key mancante o non valida. |
403 |
La struttura non esiste o non appartiene al tuo account. |
409 |
Esiste già una prenotazione con quel reference nella struttura. |
429 |
Troppe richieste di seguito: attendi qualche secondo e riprova. |
Passo successivo
Configura i webhook affinché il tuo sistema riceva l’avviso quando l’ospite termina la registrazione.