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

1

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.

Hesabınız yok mu? Başvurun · Panele giriş

2

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.

3

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.

Sayfaya gömülü araç
<div id="furn-designer"></div> <script src="https://furn.catlibtech.com/embed.js" data-key="pk_FIRMA_ANAHTARINIZ" data-target="#furn-designer" async></script>

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.

Düğme: tıklanınca tam ekran açılır
<script src="https://furn.catlibtech.com/embed.js" data-key="pk_FIRMA_ANAHTARINIZ" data-mode="button" data-button-text="Mutfağını tasarla" async></script>
Kendi bağlantılarınız ve menünüz
<script src="https://furn.catlibtech.com/embed.js" data-key="pk_FIRMA_ANAHTARINIZ" data-mode="popup" async></script> <a href="#" data-furn-open>Mutfağını tasarla</a> <a href="#" data-furn-open="banyo">Banyo dolabını tasarla</a> <a href="#" data-furn-open="gardirop">Gardırobunu tasarla</a>
ÖzellikAçıklama
data-keyFirmanızın herkese açık anahtarı (pk_...). Gizli değildir.
data-productmutfak (varsayılan), banyo veya gardirop.
data-modeinline (varsayılan, sayfaya gömülü), button veya popup.
data-targetAracı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-classDüğme yazısı, rengi ya da kendi CSS sınıfınız.
data-min-heightSayfaya 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.

OlayNe zaman
readyAraç yüklendi
stepAdım değişti (fotoğraf, duvar, tasarım, teklif, sipariş)
quoteFiyat yeniden hesaplandı
resultTasarım sitenize gönderildi (code, fiyat, modüller, simülasyon görseli)
orderSipariş verildi (code, total, deposit)
open, closeTam ekran pencere açıldı / kapandı
// Sipariş verildi (sipariş bizde oluşuyorsa) document.addEventListener('furn:order', function (e) { console.log('Sipariş', e.detail.code, e.detail.total); }); // "Sonuçları siteme gönder" modunda tasarım gönderildi FurnDesigner.on('result', function (data) { // data.code ile sunucunuzdan GET /api/v1/designs/{kod}: fiyat, parçalar, çizimler fetch('/siparis-al', { method: 'POST', body: JSON.stringify({ code: data.code }) }); });

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.
360 cm duvarı otomatik doldur ve hesapla
curl -X POST https://furn.catlibtech.com/api/v1/designs/calculate \ -H "Authorization: Bearer fk_GIZLI_ANAHTARINIZ" \ -H "Content-Type: application/json" \ -d '{ "design": { "walls": [ { "widthCm": 360, "heightCm": 260 } ] }, "autoFill": { "includeUpper": true, "includeTall": true } }'

Yanıt: price (satırlar, KDV, toplam, kapora), cutList, accessories, layout, drawings (SVG) ve uyarılar (issues).

JavaScript (sunucu tarafı)
// Sunucunuzda (Node.js 18+). Anahtar yalnızca sunucuda durur. const api = (path, init = {}) => fetch('https://furn.catlibtech.com/api/v1' + path, { ...init, headers: { Authorization: 'Bearer ' + process.env.FURN_API_KEY, 'Content-Type': 'application/json' } }).then(r => r.json()); const design = await api('/designs/K7F3QX9M'); // müşterinin gönderdiği tasarım console.log(design.price.total, design.cutList.length); await api('/orders/K7F3QX9M/status', { // üretime aldınız method: 'PUT', body: JSON.stringify({ status: 'InProduction', notify: true }) });
MetotAdresNe yapar
GET/catalogModül tipleri, ölçüler, malzemeler, kulplar (?productLine=bathroom|wardrobe)
POST/designs/calculateKaydetmeden 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}/statusSipariş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.

# Boş saatler curl "https://furn.catlibtech.com/api/v1/appointments/slots?kind=olcu&date=2026-11-10" \ -H "Authorization: Bearer fk_GIZLI_ANAHTARINIZ" # Randevu (saat Türkiye saati; dolduysa 409 slot_taken) curl -X POST https://furn.catlibtech.com/api/v1/appointments \ -H "Authorization: Bearer fk_GIZLI_ANAHTARINIZ" -H "Content-Type: application/json" \ -d '{ "kind": "olcu", "start": "2026-11-10T14:00", "name": "Ayşe Yılmaz", "phone": "05321234567", "address": "Atatürk Cad. No 5", "city": "Kadıköy" }'
  • 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}/status ile Confirmed, Completed, Cancelled, NoShow.
  • Saatler Türkiye saatidir; startsAtUtc UTC 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.

Node.js
// Express: gövdeyi ham olarak alın (express.raw) app.post('/furn-webhook', express.raw({ type: 'application/json' }), (req, res) => { const sig = 'sha256=' + crypto.createHmac('sha256', process.env.FURN_WEBHOOK_SECRET).update(req.body).digest('hex'); const given = Buffer.from(req.get('X-Furn-Signature') || ''); if (given.length !== Buffer.byteLength(sig) || !crypto.timingSafeEqual(Buffer.from(sig), given)) return res.sendStatus(401); const event = JSON.parse(req.body); // { type, createdAt, data } if (event.type === 'order.created') { /* siparişi kaydedin */ } res.sendStatus(200); });
PHP
$body = file_get_contents('php://input'); $expected = 'sha256=' . hash_hmac('sha256', $body, getenv('FURN_WEBHOOK_SECRET')); if (!hash_equals($expected, $_SERVER['HTTP_X_FURN_SIGNATURE'] ?? '')) { http_response_code(401); exit; } $event = json_decode($body, true); // ['type' => 'appointment.created', 'data' => [...]]

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.

DurumNe zaman
400Eksik veya geçersiz alan (ör. invalid_product_line, too_many_walls, invalid_start)
401API anahtarı yok veya geçersiz (unauthorized)
404Tasarı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)
429Dakikada 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.