Geliştiriciler
Tasarım aracını sitenize iki satırla ekleyin
Mutfak, banyo dolabı ve gardırop tasarımı sizin sitenizde açılır. Fiyat, kesim listesi, siparişler ve randevular REST API ve webhook ile sisteminize gelir. Hesaplar sizin malzeme, fiyat ve üretim kurallarınızla yapılır.
Üç adımda başlayın
Anahtarınızı alın
Firma panelinize girin, Entegrasyon sayfasındaki herkese açık anahtarı (pk_...) kopyalayın. Kodu sizin anahtarınızla hazır olarak orada da bulursunuz.
Kodu sayfanıza yapıştırın
Aracın görüneceği yere iki satır. WordPress'te "Özel HTML" bloğu yeterli. Banyo için data-product="banyo", gardırop için data-product="gardirop" ekleyin.
Siparişleri alın
Siparişler panelinize ve e-postanıza düşer. İsterseniz sonuçları kendi sitenize alın ya da webhook ile kendi sisteminize aktarın.
Gömme seçenekleri
Aynı script üç şekilde çalışır. Sitenizde yer ayırmak istemezseniz araç bir düğmeyle tam ekran açılır; kapatıldığında tasarım kaybolmaz.
| Özellik | Açıklama |
|---|---|
data-key | Firmanızın herkese açık anahtarı (pk_...). Gizli değildir. |
data-product | mutfak (varsayılan), banyo veya gardirop. |
data-mode | inline (varsayılan, sayfaya gömülü), button veya popup. |
data-target | Aracın (veya düğmenin) yerleşeceği eleman, ör. #furn-designer. Yoksa script'in olduğu yer. |
data-button-text, data-button-color, data-button-class | Düğme yazısı, rengi ya da kendi CSS sınıfınız. |
data-min-height | Sayfaya gömülü araçta en küçük yükseklik (px, varsayılan 720). Araç içeriğe göre uzar. |
FurnDesigner.open('banyo'), .close() | Tam ekran pencereyi JavaScript ile açıp kapatır. |
Güvenlik için panelde Entegrasyon → Aracı gömebilecek siteler alanına kendi adresinizi yazın; araç yalnızca o sitelerde açılır. Gömülü araçta siparişin nerede oluşacağını (bizde, sizin sitenizde ya da hiç) aynı sayfadan seçersiniz.
Olaylar
Araç sayfanıza olay gönderir. FurnDesigner.on('olay', fn) ile ya da document üzerinde furn:olay DOM olayı olarak dinleyin.
| Olay | Ne zaman |
|---|---|
ready | Araç yüklendi |
step | Adım değişti (fotoğraf, duvar, tasarım, teklif, sipariş) |
quote | Fiyat yeniden hesaplandı |
result | Tasarım sitenize gönderildi (code, fiyat, modüller, simülasyon görseli) |
order | Sipariş verildi (code, total, deposit) |
open, close | Tam ekran pencere açıldı / kapandı |
REST API
Kendi arayüzünüzü veya yazılımınızı kullanıyorsanız hesapları API ile yaptırın: tasarımı gönderin, fiyatı, kesim listesini, aksesuarları ve SVG çizimleri alın.
- Taban adres:
https://furn.catlibtech.com/api/v1 - Kimlik:
Authorization: Bearer fk_...(panelde Entegrasyon → API anahtarları; yalnızca sunucunuzda saklayın) - JSON; tasarımda ölçüler cm, sonuçta mm. Anahtar başına dakikada 120 istek.
Yanıt: price (satırlar, KDV, toplam, kapora), cutList, accessories, layout, drawings (SVG) ve uyarılar (issues).
| Metot | Adres | Ne yapar |
|---|---|---|
| GET | /catalog | Modül tipleri, ölçüler, malzemeler, kulplar (?productLine=bathroom|wardrobe) |
| POST | /designs/calculate | Kaydetmeden hesapla |
| POST · GET · PUT | /designs, /designs/{kod} | Tasarımı kaydet, oku, güncelle |
| GET | /designs/{kod}/elevation.svg, plan.svg, cutlist.csv | Çizimler ve kesim listesi |
| GET · PUT | /orders, /orders/{kod}/status | Siparişler ve durumları |
| GET · POST · PUT | /appointments… | Randevu türleri, boş saatler, randevu ve durumları |
Randevular
Müşterileriniz sitenizden yerinde ölçü, mağaza ziyareti veya görüşme randevusu alır. Aynı takvimi kendi sitenizden ya da çağrı merkezinizden API ile doldurun; çakışmayı sistem önler.
- Türler ve kurallar:
GET /appointments/kinds; boş günler:/appointments/days?kind=olcu. - Yanıtta
manageUrl: müşterinin randevusunu görüp iptal edebileceği ve takvimine ekleyebileceği bağlantı. - Durum:
PUT /appointments/{kod}/statusileConfirmed,Completed,Cancelled,NoShow. - Saatler Türkiye saatidir;
startsAtUtcUTC karşılığıdır.
Webhook
Panelde bir adres girerseniz olaylar oraya POST edilir: order.created, order.status_changed, design.created, appointment.created, appointment.status_changed. Gövde { type, createdAt, data }; imza X-Furn-Signature: sha256=… başlığındadır.
Webhook 6 saniye içinde yanıt bekler ve tekrar denenmez; veriyi her zaman GET /designs/{kod} veya GET /appointments/{kod} ile yeniden alabilirsiniz.
Hatalar
Hatalar her zaman aynı biçimdedir: { "error": "kod", "message": "Türkçe açıklama" }. message doğrudan kullanıcıya gösterilebilir.
| Durum | Ne zaman |
|---|---|
400 | Eksik veya geçersiz alan (ör. invalid_product_line, too_many_walls, invalid_start) |
401 | API anahtarı yok veya geçersiz (unauthorized) |
404 | Tasarım, sipariş veya randevu bulunamadı |
409 | Çakışma: seçilen randevu saati doldu (slot_taken) veya sipariş olmuş tasarım API ile değiştirilemez (is_order) |
429 | Dakikada 120 istek sınırı aşıldı; biraz bekleyip tekrar deneyin |
Ayrıntılar tam referansta
Tasarım belgesi, köşe tipleri, banyo ve gardırop, otomatik doldurma, hesap sonucu, sipariş durumları ve webhook gövdeleri.