Geliştiriciler

Müsaitlik API'si

İşletmenin hizmetlerini ve boş saatlerini kendi web sitenizde gösterin; ziyaretçi tarihi ve saati sizin sayfanızda seçsin. API yalnızca okur: randevu oluşturmaz, müşteri bilgisi vermez. Veriler işletmenin herkese açık randevu sayfasındakiyle aynıdır.

Temel bilgiler

  • Adres: https://randevu.ladom.co/api/booking/v1/{slug}. slug, işletmenin randevu sayfası adresindeki addır (randevu.ladom.co/ornek-guzellik → ornek-guzellik).
  • Anahtar gerekmez. CORS açıktır (Access-Control-Allow-Origin: *): tarayıcıdan doğrudan çağrılabilir.
  • Yanıtlar 30 saniye önbellekte tutulur. Saatler işletmenin saat diliminde (timezone), tarihler YYYY-MM-DD, saatler HH:MM, fiyatlar kuruş cinsindendir (250000 = ₺2.500).
  • Müsaitlik hizmete bağlıdır: boş saat, seçilen hizmetlerin toplam süresine ve onları veren kişilere göre hesaplanır. Bu yüzden önce hizmet listesini alın.

1. İşletme ve hizmetler

GET/api/booking/v1/{slug}

Online randevu alınabilen hizmetler, sırasıyla; her biri kimin verdiğiyle ve nasıl yapılabildiğiyle (yüz yüze, online).

json
{
  "business": {
    "name": "Örnek Güzellik",
    "slug": "ornek-guzellik",
    "timezone": "Europe/Istanbul",
    "currency": "TRY",
    "booking_url": "https://randevu.ladom.co/ornek-guzellik",
    "horizon_days": 60,
    "max_services_per_appointment": 5
  },
  "services": [
    {
      "id": "9e5315cd-267d-4630-84a8-7a9b54db6ba7",
      "name": "Cilt Bakımı",
      "description": null,
      "category": "Yüz",
      "duration_min": 40,
      "price": 250000,
      "currency": "TRY",
      "modes": ["in_person"],
      "staff": [{ "id": "bdfaaf91-bd7f-47d1-8802-801920b2efb6", "name": "Ayşe", "title": "Uzman" }]
    }
  ]
}

2. Boş saatler

GET/api/booking/v1/{slug}/availability?services=…&date=…&days=…

ParametreAçıklama
servicesZorunlu. Hizmet kimlikleri, virgülle (en çok 5). Birden fazlaysa aynı kişi tarafından art arda yapılır.
staffİsteğe bağlı. Tek bir kişinin boş saatleri; yoksa herhangi biri ("Fark etmez").
dateİsteğe bağlı. İlk gün (YYYY-MM-DD); varsayılan bugün. Geçmiş tarih bugüne çekilir.
daysİsteğe bağlı. Kaç gün (1–14); varsayılan 1. En çok 60 gün ilerisi verilir.
modein_person (varsayılan) ya da online; hizmetin modes listesinden.

Her gün için başlangıç saatleri ve o saatte boş olan kişiler (staff_ids). Boş liste: o gün yer yok (kapalı, tatil ya da dolu). İşletmenin çalışma saatleri, izinleri, tatilleri ve "en erken ne zaman" ayarı hesaba katılır.

json
{
  "timezone": "Europe/Istanbul",
  "services": ["9e5315cd-267d-4630-84a8-7a9b54db6ba7"],
  "duration_min": 40,
  "staff_id": null,
  "mode": "in_person",
  "days": [
    {
      "date": "2026-11-17",
      "slots": [
        { "time": "09:00", "staff_ids": ["bdfaaf91-bd7f-47d1-8802-801920b2efb6"] },
        { "time": "09:15", "staff_ids": ["bdfaaf91-bd7f-47d1-8802-801920b2efb6"] }
      ]
    },
    { "date": "2026-11-18", "slots": [] }
  ]
}

Örnek

js
const base = "https://randevu.ladom.co/api/booking/v1/ornek-guzellik";

// 1. Services (and who gives them)
const { services } = await fetch(base).then((r) => r.json());

// 2. Free times for the chosen service, the next 7 days
const url = new URL(base + "/availability");
url.searchParams.set("services", services[0].id);
url.searchParams.set("days", "7");
const { days } = await fetch(url).then((r) => r.json());

for (const day of days) {
  console.log(day.date, day.slots.map((s) => s.time).join(", "));
}

Hatalar

Hatalar { "error": { "code", "message" } } biçimindedir.

HTTPcodeNe zaman
404not_foundBu adreste online randevu alan işletme yok, ya da hizmet/kişi bulunamadı.
422validation_errorParametre eksik ya da hatalı (ör. services yok).

Randevuyu tamamlamak

Ziyaretçi sitenizde hizmeti, günü ve saati seçtiyse bunları booking_url adresine ekleyin; randevu sayfası doğrudan bilgi formunda açılır: ?service=…&date=2026-11-18&time=10:00. Birden fazla hizmet virgülle (service=a,b), kişi staff=…, yüz yüze/online mode=in_person|online ile gönderilir. Saat bu arada dolduysa sayfa o günün boş saatlerini bir notla gösterir. Geçersiz değerler yok sayılır.

Bu sürümde API randevu oluşturmaz. Ziyaretçiyi işletmenin randevu sayfasına (booking_url) yönlendirin. Sorularınız için: hello@ladom.co