> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gridbeds.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API-ul de distribuție

> Citește proprietățile, prețurile și disponibilitatea pe care gazdele din Gridbeds le publică pe site-ul tău de listări și află când se schimbă.

<Warning>
  **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](/ro/distribution-api/testing)); sandbox-ul se deschide odată cu prima cheie de test. Trimite comentarii despre orice parte a lui la [support@gridbeds.com](mailto:support@gridbeds.com).
</Warning>

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.

| Resursă | Ce este |
| - | - |
| **Locație** (location) | O clădire sau o adresă unde sunt proprietăți publicate: adresă, coordonate, fus orar, fotografii. |
| **Proprietar** (owner) | Cine oferă proprietățile: o firmă sau o persoană fizică, cu un nume afișat și, pentru o firmă, datele ei legale. |
| **Proprietate** (property) | O listare pentru fiecare tip de cameră: unitățile, capacitatea, fotografiile, planurile tarifare, taxele, orele de check-in și check-out, regulile casei și datele legale cerute de țara ei. |
| **Disponibilitate** (availability) | Pe proprietate și pe noapte: unitățile disponibile, șederea minimă și maximă, închiderile la sosire și la plecare și un preț pentru fiecare plan tarifar. |
| **Facilitate** (amenity) | Catalogul de coduri de facilități folosite de proprietăți, cu codurile OpenTravel corespunzătoare. |
| **Eveniment** (event) | O intrare din jurnalul schimbărilor, același lucru pe care îl livrează un webhook. |

`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

| Mediu | URL de bază | Chei |
| - | - | - |
| Producție | `https://api.gridbeds.com/api/v1/distribution` | `gbd_live_…` |
| Sandbox | `https://staging-api.gridbeds.com/api/v1/distribution` | `gbd_test_…` |

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

<CardGroup cols={2}>
  <Card title="Autentificare" icon="key-round" href="/ro/distribution-api/authentication">
    Chei, permisiuni și rotație.
  </Card>

  <Card title="Sincronizare" icon="refresh-cw" href="/ro/distribution-api/synchronisation">
    Liste, `updated_since`, versiuni și tombstone-uri.
  </Card>

  <Card title="Date legale" icon="scale" href="/ro/distribution-api/legal-data">
    Ce cere legea fiecărei țări să arate o listare.
  </Card>

  <Card title="Webhook-uri" icon="webhook" href="/ro/distribution-api/webhooks">
    Verificarea semnăturii, reîncercări și suspendare.
  </Card>

  <Card title="Erori și limite" icon="triangle-alert" href="/ro/distribution-api/errors-and-limits">
    Problem details și anteturile `RateLimit`.
  </Card>

  <Card title="Testare" icon="flask-conical" href="/ro/distribution-api/testing">
    Azi un mock al contractului, apoi sandbox-ul.
  </Card>
</CardGroup>

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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.