Hella API per partner
Documentazione pubblica della Partner API v1 per integrare catalogo, disponibilità, preventivi indicativi e handoff sicuro.
Versione: 1.0.0-beta.1 · Stato: beta · Ultimo aggiornamento: 2026-07-13
Base URL
https://www.app.hellastays.com/app/api
Accesso
Questa documentazione è pubblica. Le richieste Partner API v1 richiedono una credenziale Bearer partner revocabile da conservare server-side.
Operazioni
GET /v1/properties— Search partner-visible properties (listPartnerProperties)GET /v1/properties/{propertyId}— Get a property (getPartnerProperty)GET /v1/properties/{propertyId}/availability— Check property availability (getPartnerPropertyAvailability)POST /v1/quotes— Create an indicative quote (createPartnerQuote)
Contratti scaricabili
Garanzie del contratto
Gli ID sono stringhe opache. Le date usano YYYY-MM-DD e l’intervallo [checkIn, checkOut) nel fuso locale della proprietà. Gli importi sono decimal string. Gli errori usano application/problem+json con code e correlationId.
Il preventivo è indicativo e il prezzo non viene preservato nell’handoff. Usa l’handoffUrl assoluto senza modificarlo.
OpenAPI è la fonte di verità machine-readable per operazioni, schemi, esempi ed errori.
La pagina non richiede login e i contenuti fondamentali sono disponibili anche senza JavaScript.