Mekanlar

Masaları listele

Mekanın katları, terasları ve salonları; her biri masalarıyla, kasada göründüğü sırayla.

GET/public/v1/venues/{venueId}/tables

Kimlik doğrulama: X-Api-Key başlığında API anahtarı
Gereken izin: Menüyü okuyabilir (her anahtarda var)
Hız sınırı: Anahtar başına dakikada yaklaşık 120 istek

Masada verilen bir sipariş (DineIn) buradaki masalardan birini id değeriyle adlandırır. Masaların kasadaki sırası korunur: önce mekanın düzenledikleri, sonra kalanlar adlarına göre, sayılar sayı olarak okunarak (T2, T10'dan önce gelir).

Rehber: Mekanlar ve şubeler

Parametreler

venueIdstring · uuidYol parametresizorunlu

Mekanın kimliği, mekan listesinden.

Accept-LanguagestringBaşlık

Hata yanıtlarındaki userMessage metninin dili: tr (varsayılan), en, de, fr, it, es, ar ya da ru. Başlıktaki ilk dil belirler, bölgesi olmadan (en-US, en okunur) ve q ağırlıklarına bakılmadan; Cibusy'nin sunmadığı bir dil Türkçe yanıtlanır. Menünün dilini seçmez; o, menü çağrısındaki lang parametresidir.

Yanıtlar

200

Mekanın alanları ve masaları.

401

X-Api-Key başlığı yok (PUBLIC_API_KEY_MISSING) ya da anahtar geçersiz veya iptal edilmiş (PUBLIC_API_KEY_INVALID).

403

Anahtar bu çağrıyı yapamaz (PUBLIC_API_SCOPE_MISSING). Panelde oluşturulan her anahtar mekanları, menüleri ve masaları okuyabilir.

404

Mekan yok ya da bu anahtar ona ulaşamıyor (PUBLIC_API_VENUE_NOT_FOUND).

429

Anahtarın dakikada yaklaşık 120 isteklik bütçesi doldu; Retry-After kadar saniye bekleyin.

Retry-After

Beklenecek saniye. Bir sonraki dakikalık pencere bu süre içinde açılır.

Başarılı yanıtın `data` alanı: bu nesnelerin dizisi

Mekanın bir katı, terası ya da salonu ve içindeki masalar. Masada verilen sipariş bu masalardan birini adlandırır.

idstring · uuid

Alanın kimliği.

namestring

Alanın adı.

displayOrderinteger

Alanın mekanın alanları arasındaki sırası, küçük olan önce. Alanlar zaten bu sırayla gelir.

tablesobject[]

Alanın masaları, mekanın kasasında göründüğü sırayla: önce mekanın düzenledikleri, sonra kalanlar adlarına göre, sayılar sayı olarak okunarak (T2, T10'dan önce). Henüz masası olmayan alanda boş.

Masa alanları

idstring · uuid

Masanın kimliği; masada verilen sipariş bunu kullanır.

namestring

Masanın kasada yazdığı adı.

codestringnull olabilir

Masanın QR kartında yazan kod. Kodu olmayan masada null.

capacityintegernull olabilir

Masanın kaç kişilik olduğu. Mekan belirtmediyse null.

İstek örneği

curl "https://api.cibusy.com/public/v1/venues/3fa85f64-5717-4562-b3fc-2c963f66afa6/tables" \
  -H "X-Api-Key: $CIBUSY_API_KEY"

Yanıt örneği

200 OK

{
  "success": true,
  "timestamp": "2026-10-01T09:30:00.123Z",
  "traceId": null,
  "data": [
    {
      "id": "1e3a5c7d-9f0b-4d2e-8a4c-6b8d0f2a4c61",
      "name": "Salon",
      "displayOrder": 1,
      "tables": [
        {
          "id": "2f4e6a8c-0b1d-4c3e-9f5a-7b9d1e3c5a70",
          "name": "M1",
          "code": "K7PX2A",
          "capacity": 4
        },
        {
          "id": "4a6c8e0f-2b3d-4f5a-8c7e-9d1f3a5b7c92",
          "name": "M2",
          "code": "Q4ZT9B",
          "capacity": 2
        }
      ]
    },
    {
      "id": "8d0f2b4a-6c8e-4a1b-9d3f-5e7a9c1b3d85",
      "name": "Bahçe",
      "displayOrder": 2,
      "tables": [
        {
          "id": "6c8e0a2b-4d5f-4b7c-9e1a-3f5b7d9a1c34",
          "name": "B1",
          "code": null,
          "capacity": 6
        }
      ]
    }
  ],
  "message": "Operation completed successfully"
}

Hata örneği

404 Not Found

{
  "success": false,
  "userMessage": "Mekan bulunamadı ya da bu API anahtarı bu mekana erişemiyor.",
  "developerMessage": "Venue not found, or this API key cannot access it.",
  "errorCode": "PUBLIC_API_VENUE_NOT_FOUND",
  "validationErrors": null,
  "details": null,
  "timestamp": "2026-10-01T09:30:00.123Z",
  "traceId": null
}

Masaları listele

Parametreler

Yanıtlar

Başarılı yanıtın data alanı: bu nesnelerin dizisi

Başarılı yanıtın `data` alanı: bu nesnelerin dizisi