Ubytovačka API (v1)

Authorization: Bearer {ROOM_API_KEY}

{
  "id": "{EVENT_ID}",
  "title": "Rezervace",
  "start": "2026-03-30",
  "end": "2026-04-01",
  "guests": 2,
  "external_id": "string | null"
}

external_id je volitelné externí ID (viz sekce External ID).

• Rozsah je vždy [start, end) — check-in je start, check-out je end.
• Overlap kontrola je start < existing_end AND end > existing_start.

HTTP 409
{"error":"external_id_conflict","hint":"This external_id already exists in this event","fields":["persons.0.external_id"]}

Typ Person se používá v různých requestech/responsech (např. POST /events → persons[], PATCH /events/{EVENT_ID} → persons_add[], a výpis hostů v GET /events/{EVENT_ID}/guests). Konkrétní povinnost polí se může lišit podle endpointu – zde je uveden tvar objektu a význam polí.

{
  "title": "Novákovi",
  "start": "2026-04-01",
  "end": "2026-04-06",
  "guests": 3,
  "external_id": "EXT-RES-12345",
  "persons": [
    {
      "external_id": "EXT-GUEST-1",
      "name": "Jan",
      "surname": "Novák",
      "sex_id": 1,
      "category_id": 12,
      "birth_date": "1980-10-10",
      "document_id": 10,
      "document_number": "123456789",
      "street": "Evropská 1171/10",
      "city": "Praha 4",
      "country_code": "CZE",
      "purpose": 9
    }
  ]
}

• persons je volitelné. Pokud je uvedeno, musí být pole (array).
• Pokud je persons uvedeno, musí obsahovat alespoň 1 položku.
• persons nesmí mít více položek než guests.
• guests musí být >= 1.
• Pokud má pokoj nastavenou kapacitu, platí limit pro guests i pro počet položek v persons.
• Datum je YYYY-MM-DD a rozsah je start < end.

Bez body. Pouze URL + Authorization.

GET /v1/events/{EVENT_ID}
Authorization: Bearer {ROOM_API_KEY}

• PATCH je partial update – posíláš jen pole, která chceš změnit.
• guests nesmí být menší než aktuální počet existujících hostů u eventu.
• persons_add může obsahovat jen tolik položek, kolik dovolí guests a kapacita pokoje.
• leader se přes API nenastavuje.
• external_id (eventu) je volitelné a lze ho měnit přes PATCH. Hodnota může být null.

{
  "title": "Novotní + babička",
  "external_id": "EXT-RES-12345-UPDATED",
  "guests": 3,
  "persons_add": [
    {
      "external_id": "EXT-GUEST-3",
      "name": "Marie",
      "surname": "Novotná",
      "sex_id": 2,
      "category_id": 12,
      "birth_date": "1950-05-05",
      "document_id": 10,
      "document_number": "CZ99999999",
      "street": "Květná 12",
      "city": "Brno",
      "country_code": "CZE",
      "purpose": 9
    }
  ]
}

persons_add je volitelné. Pokud se pošle, přidají se nové osoby do eventu.

Bez body. Pouze URL + Authorization.

POST /v1/events/{EVENT_ID}/confirm
Authorization: Bearer {ROOM_API_KEY}

Bez body. Pouze URL + Authorization.

DELETE /v1/events/{EVENT_ID}
Authorization: Bearer {ROOM_API_KEY}

{
  "email": "marie.novotna@example.com",
  "phone": "+420777123456",
  "note": "babička"
}

PATCH je “partial update” – pošlete jen pole, která chcete změnit.

Bez body. Pouze URL + Authorization.

DELETE /v1/events/{EVENT_ID}/guests/{GUEST_ID}
Authorization: Bearer {ROOM_API_KEY}

Event i host musí patřit do stejného pokoje (určeno API klíčem) a host musí patřit do daného eventu.

{
  "email": "guest@example.com"
}

{
  "ok": true,
  "items": [
    { "id": 1, "code": "optional", "name": "string" }
  ]
}

• id se používá v requestech jako *_id (např. sex_id).
• code může být null (pokud pro daný seznam nedává smysl).
• U států se posílá country_code jako 3 písmena (např. CZE).

Všechny meta endpointy vyžadují autorizaci (viz sekce Autorizace) a chyby jsou popsané v Status kódy & chyby.

Některá pole v requestech musí odpovídat hodnotám z meta endpointů. Pokud pošleš neexistující ID/kód, API vrátí 422 a konkrétní error.

HTTP 422
  {"error":"invalid_category_id","fields":["persons.0.category_id"]}

HTTP 422
  {"error":"invalid_country_code","fields":["persons.0.country_code"]}

curl -s \
  -H "Authorization: Bearer $UBY_API_KEY" \
  "https://api.uby.app/v1/meta/sex"

curl -s \
  -H "Authorization: Bearer $UBY_API_KEY" \
  "https://api.uby.app/v1/meta/document-types"

curl -s \
  -H "Authorization: Bearer $UBY_API_KEY" \
  "https://api.uby.app/v1/meta/categories"

curl -s \
  -H "Authorization: Bearer $UBY_API_KEY" \
  "https://api.uby.app/v1/meta/purposes"

curl -s \
  -H "Authorization: Bearer $UBY_API_KEY" \
  "https://api.uby.app/v1/meta/countries"

{
  "error": "string",
  "hint": "string (optional)",
  "fields": ["field1","field2"] (optional)
}

not_found u rezervací znamená, že rezervace buď neexistuje, nebo nepatří do pokoje daného API klíčem. Díky tomu nejde “hádat” cizí rezervace.

HTTP 409
{"error":"external_id_conflict","hint":"This external_id already exists in this event","fields":["persons.0.external_id"]}