Kimlik doğrulama
Çiçeksepeti isteklerinde mağazanın API anahtarı x-api-key başlığıyla gönderilir. Token alma ya da imza üretme adımı yoktur. İstek gövdeleri JSON'dur. Bazı entegrasyonlar ayrıca User-Agent başlığına mağazaya özgü bir değer yazar.
API anahtarı Çiçeksepeti satıcı panelinden alınır. Ayrıntı: Çiçeksepeti API key nasıl alınır.
Temel adres ve servisler
Servisler https://apis.ciceksepeti.com adresindedir. Çalışan bir entegrasyonda kullanılan başlıca yollar şunlardır:
| İşlem | Yöntem ve yol |
|---|---|
| Ürün listeleme | GET /api/v1/Products |
| Ürün yükleme | POST /api/v1/Products |
| Stok ve fiyat | PUT /api/v1/Products/price-and-stock |
| İşlem (batch) sonucu | GET /api/v1/Products/batch-status/{batchId} |
| Ürün silme | DELETE /api/v1/Products/{kod} |
| Kategori ağacı | GET /api/v1/Categories |
| Kategori özellikleri | GET /api/v1/Categories/{id}/attributes |
| Sipariş listeleme | POST /api/v1/Order/GetOrders |
Ürün yükleme ve stok-fiyat güncellemesi asenkrondur: yanıt yalnız bir batchId verir, sonucu batch-status servisinden okursunuz.
Ortamlar ve doküman
Bu rehber hazırlanırken apis.ciceksepeti.com altındaki doküman sayfaları dışarıdan açılamadı. Teknik ayrıntılar, Çiçeksepeti'ye canlıda bağlanan bir entegrasyonun kodundan doğrulandı. Test (sandbox) ortamı hakkında doğrulanmış bir bilgiye ulaşamadık. Güncel alan listesini ve ortam bilgisini Çiçeksepeti'nin size ilettiği API dokümanından kontrol edin.
İstek sınırları
Çiçeksepeti sınır aşımında "Limit aşımı!" ile başlayan ve "Kalan Süre: NN saniye" bilgisini içeren bir mesaj döndürür. Canlı kullanımda görülen kalıplar şunlardır:
| Kalıp | Gözlem |
|---|---|
| Aynı istek | Ürün listesinde aynı isteğin 10 dakikada bir kez kabul edildiği görüldü |
| Sipariş listeleme | Dakikada bir istek sınırı görüldü |
| Farklı istekler | Arka arkaya farklı isteklerde 5 saniyede bir sınırı görüldü |
| Sayfa boyutu | PageSize 100'den fazla olamaz |
Ayrıntı: Çiçeksepeti API istek sınırları.
Genel hata yapısı
Hatalı isteklerde HTTP 400 ya da 404 ile birlikte bir message alanı döner. Batch işlemlerinde ise HTTP isteği başarılı olsa bile ürün bazında Failed sonucu gelebilir; nedenler failureReasons listesinde message ve code alanlarıyla yazar. Sık görülen mesajlar için Çiçeksepeti API hata mesajları sayfasına bakın.
Çiçeksepeti API işlemleri
Genel
Ürün ve katalog
Stok ve fiyat
Sipariş
Sık sorulanlar
Çiçeksepeti API ücretli mi?
Çiçeksepeti'nin API erişimi için ayrı bir ücret duyurusuna rastlamadık. API anahtarı satıcı panelinden alınır. Güncel koşulları satıcı panelinden ya da Çiçeksepeti destek ekibinden doğrulayın.
Çiçeksepeti API'de müşteri soruları var mı?
Çalışan bir entegrasyonda soru servisi denendiğinde 404 yanıtı alındı (Temmuz 2026). Müşteri soruları şimdilik satıcı panelinden yanıtlanıyor.
Çiçeksepeti ürünleri neden hemen yayına girmiyor?
Yüklenen ürünler Çiçeksepeti'nin inceleme sürecinden geçer. İnceleme 24 saate kadar sürebilir; canlı kullanımda daha uzun süren istekler de görüldü. Ayrıntı ürün onay süreci sayfasındadır.
Çiçeksepeti entegrasyonu için hangi bilgiler gerekir?
Kendi entegrasyonunuz için API anahtarı yeterlidir; istekler x-api-key başlığıyla gider. Hazır yazılımlar ayrıca satıcı numaranızı ve isteğe bağlı bir User-Agent değeri isteyebilir.