Availability

Public booking API · https://api.conciar.com/public/v1

INFO

API 參考文件以英文撰寫。

Days of a month

Every day of the month as open, closed, full or unavailable (outside the booking window) for a party size.

GET/public/v1/restaurants/{organization_guid}/calendar

不需金鑰

速率限制: 120/min per restaurant and IP

路徑參數

• organization_guidstring必填

  The restaurant's guid or its handle (any case, a leading @ is ignored; former handles still resolve).

查詢參數

• party_sizeinteger必填

  Guests, 1 up to booking.max_party from GET /restaurants/{organization_guid} (never more than 20).

• monthstring必填

  Y-m.

狀態碼

• 404NOT_FOUND (unknown restaurant) or UNAVAILABLE (the restaurant takes no online bookings).
• 422INVALID, with errors.

curl "https://api.conciar.com/public/v1/restaurants/bistro-example/calendar?party_size=2&month=2026-10" \
  -H "Accept: application/json"

回應範例 · 200

{
  "status": true,
  "month": "2026-10",
  "days": {
    "2026-10-16": "open",
    "2026-10-17": "full",
    "2026-10-18": "closed",
    "…": "…"
  }
}

Times on a day

The bookable times for a date and party size, each with the deposit or card guarantee that applies, plus the ticketed events that day (their times are not bookable as a normal table).

GET/public/v1/restaurants/{organization_guid}/times

不需金鑰

速率限制: 120/min per restaurant and IP

路徑參數

• organization_guidstring必填

  The restaurant's guid or its handle (any case, a leading @ is ignored; former handles still resolve).

查詢參數

• party_sizeinteger必填

  Guests, 1 up to booking.max_party from GET /restaurants/{organization_guid} (never more than 20).

• datestring必填

  Y-m-d.

• langstring

  en, nl, de, fr or es. Falls back to Accept-Language, then the restaurant's language, then en.

狀態碼

• 404NOT_FOUND or UNAVAILABLE.
• 422INVALID.

注意事項

• deposit is {per_person, total} and guarantee {fee, total, basis (per_guest or per_booking), free_cancellation_hours} (amounts as money) or null. events[]: {id, name, url}. A date outside the booking window gives times: []. lang only affects the event names.

curl "https://api.conciar.com/public/v1/restaurants/bistro-example/times?party_size=2&date=2026-10-24" \
  -H "Accept: application/json"

回應範例 · 200

{
  "status": true,
  "date": "2026-10-24",
  "times": [
    {
      "time": "18:00",
      "deposit": null,
      "guarantee": null
    },
    {
      "time": "19:00",
      "deposit": null,
      "guarantee": null
    }
  ],
  "events": []
}