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), tarihlerYYYY-MM-DD, saatlerHH: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).
{
"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=…
| Parametre | Açıklama |
|---|---|
services | Zorunlu. 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. |
mode | in_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.
{
"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
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.
| HTTP | code | Ne zaman |
|---|---|---|
| 404 | not_found | Bu adreste online randevu alan işletme yok, ya da hizmet/kişi bulunamadı. |
| 422 | validation_error | Parametre 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