API e Webhook

GUIDA: API prenotazioni, crea prenotazioni dal tuo software

Di: Diego Betancor, CTO · Ingegnere informatico ed economista aziendale

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.
{
  "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.