Skip to main content
Încă nu este servit. Pagina descrie contractul final, versiunea 1.0.0. Până se deschide sandbox-ul, odată cu prima cheie de test, încearcă-l pe un mock al contractului (Testare).
Rapoartele de listare merg în sens invers față de restul API-ului: îi spui lui Gridbeds ce s-a întâmplat cu fiecare listare de pe canalul tău și cum merge. Gridbeds îi arată gazdei asta în panoul ei (vizualizări, clicuri spre rezervare, dacă o listare este publicată și promovată) și le pune lângă rezervările care vin de la tine. Toate operațiile de aici, inclusiv citirea înapoi a unui raport, cer permisiunea write:listings, iar Gridbeds nu trimite niciun webhook pentru ele: el este cel care primește.

​
Starea unei listări

PUT /properties/{property_id}/listing înlocuiește starea listării tale pentru o proprietate. Trimite-o de fiecare dată când starea se schimbă la tine:
  • O înlocuire completă, idempotentă: dacă trimiți din nou același corp, nu se schimbă nimic.
  • Câștigă cel mai recent updated_at. Un raport mai vechi decât cel păstrat nu schimbă nimic și răspunde cu cel păstrat, așa că reîncercările și ordinea schimbată nu fac rău. Un updated_at cu mai mult de 300 de secunde înaintea ceasului Gridbeds este refuzat (invalid_parameters, errors[].code updated_at_in_future), ca un singur ceas greșit să nu poată bloca raportul pentru totdeauna.
  • O proprietate pe care nu o poți citi ca activă sau inactivă primește același 404 ca GET /properties/{property_id} pentru un id necunoscut. Un raport deja păstrat rămâne și îi este arătat gazdei și după o retragere.
  • Răspunsul este raportul păstrat de Gridbeds, cu property_id și received_at. Un raport costă o unitate din limita ta de cereri.
GET /properties/{property_id}/listing citește înapoi raportul păstrat de Gridbeds și răspunde cu 404 până când trimiți unul.

​
Statistici zilnice

POST /listing-stats primește totaluri zilnice, câte un element pentru fiecare proprietate și dată locală a proprietății, cel mult 1.000 într-o cerere:
  • Idempotent pe proprietate și dată. O retrimitere suprascrie ziua, așa că poți trimite cifrele parțiale de azi de câte ori vrei și corectezi o zi trecută trimițând-o din nou.
  • Totul sau nimic. O cerere cu orice element invalid nu păstrează nimic și răspunde cu 400, cu câte o intrare în errors[] pentru fiecare element invalid (pointer /data/<index>/<member>). Corectează și retrimite tot lotul, ceea ce idempotența face sigur.
  • Un element este invalid când proprietatea lui nu ți-a fost distribuită niciodată (unknown_property), când data lui este după ziua de azi a proprietății sau cu mai mult de 90 de zile înainte (date_out_of_range) sau când lotul numește de două ori aceeași proprietate și dată (duplicate_day). O proprietate retrasă sau ștearsă între timp primește în continuare zilele în care ți-a fost distribuită.
  • Răspunsul spune câte zile-proprietate au fost păstrate (accepted) și când (received_at).
  • Zilele se păstrează 25 de luni, ca o gazdă să poată compara o lună cu aceeași lună de acum un an, apoi se șterg.
  • O cerere costă max(1, ceil(items / 100)) unități din limita ta de cereri.