Skip to main content
Preview: nimic nu este servit încă. API-ul de distribuție este un contract publicat în versiunea 1.0.0, iar fiecare operație din el este planificată, încă neactivă. Construiește azi pe un mock al contractului (Testare); sandbox-ul se deschide odată cu prima cheie de test. Trimite comentarii despre orice parte a lui la support@gridbeds.com.
API-ul de distribuție Gridbeds este pentru site-urile de listări și alte canale de distribuție. Îi dă canalului tău locațiile, proprietarii și proprietățile pe care gazdele din Gridbeds aleg să ți le publice, cu disponibilitatea, prețurile și restricțiile fiecărei proprietăți pe nopți, și îți spune când se schimbă oricare dintre ele.

​
Datele le citești, notificările vin la tine

Citești totul cu cereri GET. Un webhook spune doar că ceva s-a schimbat și numește ce anume: citește resursa numită ca să vezi ce s-a schimbat. Aceleași notificări le poți citi și ca jurnal ordonat, GET /events, și așa recuperezi orice ai ratat. GET /channel descrie canalul căruia îi aparține cheia ta: mediul, permisiunile (scope-urile) cheii, limita ta de cereri și câte proprietăți îți sunt distribuite. O poate apela orice cheie.

​
Medii

Se acceptă doar HTTPS, cu TLS 1.2 sau mai nou. O cerere pe HTTP simplu este refuzată, niciodată redirecționată, pentru că cheia ei a trecut deja necriptată prin rețea: consider-o compromisă și înlocuiește-o.

​
Convenții

  • Id-urile sunt șiruri opace cu un prefix (loc_, own_, prp_, rpl_, pho_, whk_, dlv_, evt_), specifice canalului tău și niciodată refolosite. Nu le interpreta.
  • Momentele sunt RFC 3339 în UTC, la secundă, terminate cu Z: 2026-10-16T09:30:00Z.
  • Nopțile sunt date în fusul orar al proprietății (timezone).
  • Banii sunt {"amount": 45000, "currency": "RON"}: un întreg în subunitățile ISO 4217, deci 45000 RON înseamnă 450,00 lei.
  • Textul este o hartă de la o limbă BCP 47 la text simplu și conține întotdeauna limba sursă a proprietății: ro pentru o proprietate din România. Nu conține HTML, linkuri, adrese de e-mail sau numere de telefon.
  • Orice enumerare este deschisă: acceptă și valori pe care nu le cunoști.

​
Versiuni

Versiunea 1 doar crește: câmpuri noi, valori noi într-o enumerare, tipuri noi de evenimente și scheme noi de identificatori legali apar fără o versiune nouă. O schimbare incompatibilă înseamnă o versiune nouă, /v2, anunțată cu cel puțin 30 de zile înainte prin anteturile Deprecation și Sunset.

​
Mai departe

Autentificare

Chei, permisiuni și rotație.

Sincronizare

Liste, updated_since, versiuni și tombstone-uri.

Date legale

Ce cere legea fiecărei țări să arate o listare.

Webhook-uri

Verificarea semnăturii, reîncercări și suspendare.

Erori și limite

Problem details și anteturile RateLimit.

Testare

Azi un mock al contractului, apoi sandbox-ul.
Fiecare pagină de la Referință este generată din contract, documentul OpenAPI după care acest API va fi construit și verificat. Paginile de referință sunt în engleză, ca documentul din care sunt generate.