Skip to main content
Anteprima: non è ancora attivo nulla. L’API di distribuzione è un contratto pubblicato nella versione 1.0.0, e ogni operazione è prevista, non ancora attiva. Oggi puoi sviluppare su un mock del contratto (Test); la sandbox apre con la prima chiave di test. Manda i tuoi commenti su qualsiasi parte a support@gridbeds.com.
L’API di distribuzione di Gridbeds è per i portali di annunci e gli altri canali di distribuzione. Dà al tuo canale le sedi, i proprietari e le strutture che gli host su Gridbeds scelgono di pubblicarti, con la disponibilità notte per notte, i prezzi e le restrizioni di ogni struttura, e ti avvisa quando qualcosa cambia.

​
I dati li leggi tu, gli avvisi arrivano da noi

Leggi tutto con richieste GET. Un webhook dice solo che qualcosa è cambiato e lo nomina: leggi la risorsa che nomina per vedere cosa è cambiato. Gli stessi avvisi li puoi leggere anche come registro ordinato, GET /events, ed è così che recuperi quello che ti sei perso. GET /channel descrive il canale a cui appartiene la tua chiave: l’ambiente, i permessi (scope) della chiave, il tuo limite di richieste e quante strutture ti sono distribuite. Può chiamarlo qualsiasi chiave.

​
Ambienti

Si accetta solo HTTPS, con TLS 1.2 o successivo. Una richiesta in HTTP semplice viene rifiutata, mai reindirizzata, perché la sua chiave ha già attraversato la rete in chiaro: considerala compromessa e sostituiscila.

​
Convenzioni

  • Gli id sono stringhe opache con un prefisso (loc_, own_, prp_, rpl_, pho_, whk_, dlv_, evt_), specifiche del tuo canale e mai riusate. Non interpretarle.
  • Gli istanti sono RFC 3339 in UTC, al secondo, con la Z finale: 2026-10-16T09:30:00Z.
  • Le notti sono date nel fuso orario della struttura (timezone).
  • Gli importi sono {"amount": 45000, "currency": "RON"}: un intero nelle unità minori ISO 4217, quindi 45000 RON sono 450,00 lei.
  • I testi sono una mappa da una lingua BCP 47 a testo semplice, e contengono sempre la lingua di origine della struttura: ro per una struttura in Romania. Niente HTML, link, indirizzi e-mail o numeri di telefono.
  • Ogni enumerazione è aperta: accetta anche valori che non conosci.

​
Versioni

La versione 1 cresce soltanto: campi nuovi, valori nuovi in un’enumerazione, nuovi tipi di evento e nuovi schemi di identificativi legali arrivano senza una nuova versione. Una modifica incompatibile è una nuova versione, /v2, annunciata con almeno 30 giorni di anticipo con le intestazioni Deprecation e Sunset.

​
Continua

Autenticazione

Chiavi, permessi e rotazione.

Sincronizzazione

Elenchi, updated_since, versioni e tombstone.

Dati legali

Cosa chiede la legge di ogni paese a un annuncio.

Webhook

Verifica della firma, nuovi tentativi e sospensione.

Errori e limiti

Problem details e le intestazioni RateLimit.

Test

Oggi un mock del contratto, poi la sandbox.
Ogni pagina sotto Riferimento è generata dal contratto, il documento OpenAPI su cui questa API sarà costruita e verificata. Le pagine di riferimento sono in inglese, come il documento da cui sono generate.