Başlıklar
Çalışan bir entegrasyonun gönderdiği başlıklar şunlardır:
| Başlık | Örnek değer | Not |
|---|---|---|
| x-api-key | API_KEY | Zorunlu; mağazanın API anahtarı |
| Content-Type | application/json | POST ve PUT isteklerinde |
| User-Agent | MAGAZA_DEGERI | İsteğe bağlı; tanımlanmışsa gönderilir |
Bütün yollar /api/v1/ ile başlar; ürün görseli güncellemesinde /api/v2/Products yolu kullanılır. HTTP başlık adları büyük-küçük harfe duyarsızdır, değerin kendisi ise birebir doğru olmalıdır.
Örnek bir okuma isteği
Kimliği doğrulamak için en basit istek ürün listesidir. İsteğin parçaları şöyledir:
- Yöntem ve adres: GET https://apis.ciceksepeti.com/api/v1/Products
- Sorgu parametreleri: Page=1, PageSize=1
- Başlık: x-api-key: API_KEY
Başarılı yanıt totalCount ve products alanlarını içerir. products dizisindeki her ürün productCode, stockCode, productName, stockQuantity, salesPrice ve listPrice gibi alanlarla gelir. Bu istek veri değiştirmediği için anahtarı denemeye uygundur. Yalnız aynı isteği 10 dakika içinde tekrarlamamaya dikkat edin; tekrar limit mesajı üretir.
User-Agent ne zaman gerekir?
Bazı entegrasyon yazılımları Çiçeksepeti bağlantısında isteğe bağlı bir User-Agent alanı sunar. Bu değer mağazanıza özel olarak iletildiyse başlığa yazılır; iletilmediyse boş bırakılır.
Dikkat edilmesi gereken bir tuzak var: sipariş listeleme isteğinde tarih biçimi yanlış olduğunda Çiçeksepeti 200 yanıtı ve "user-agent uyuşmuyor" benzeri bir uyarı döndürüp listeyi boş verebiliyor. Canlıda yapılan incelemede asıl nedenin User-Agent değil tarih biçimi olduğu görüldü. Ayrıntı için Çiçeksepeti sipariş listeleme sayfasına bakın.
Hata ayıklama sırası
Bir istek başarısız olduğunda nedeni şu sırayla daraltın:
- Yanıt metni: Hata gövdesindeki message alanını okuyun. "Limit aşımı" yazıyorsa sorun kimlik değil sınırdır.
- Yol: Yanlış yol 404 döndürür. Örneğin siparişler için GET /api/v1/Orders değil, POST /api/v1/Order/GetOrders kullanılır.
- Anahtar: Boşluk, eksik karakter ya da yanlış mağazanın anahtarı yetki hatası üretir.
- Gövde: Tarih, sayfa boyutu ve alan adları doğru mu? Sayfa boyutu 100'ü aşınca istek 400 ile reddedilir.
- Uyarı alanı: Sipariş yanıtındaki warningMessage alanı dolu gelebilir. Liste boşsa bu alanı da kaydedin.
Güvenlik notları
Anahtar tek başına tam yetki verdiği için istekleri yalnız sunucu tarafından atın. Temel adresi yapılandırılabilir tutuyorsanız yalnız Çiçeksepeti'nin https adreslerine izin verin; aksi hâlde yapılandırma hatası anahtarınızı başka bir sunucuya gönderebilir.
Yanıtları kayda geçirirken alıcı adı, telefon ve adres gibi kişisel verileri maskeleyin. Sipariş yanıtları bu bilgileri açık metin taşır.
Sık sorulanlar
Çiçeksepeti API hangi başlıkla doğrulanır?
x-api-key başlığıyla. Başlığa mağazanın API anahtarı yazılır; Authorization ya da Bearer token kullanılmaz.
"user-agent uyuşmuyor" uyarısı alıyorum, ne yapmalıyım?
Önce sipariş isteğindeki tarihleri kontrol edin. Canlı incelemede bu uyarının, tarih milisaniyeli ve Z ekli tam ISO biçiminde gönderilmediğinde çıktığı görüldü.
Çiçeksepeti API'nin temel adresi nedir?
https://apis.ciceksepeti.com. Ürün, kategori ve sipariş yolları /api/v1/ ile başlar; görsel güncellemede /api/v2/Products kullanılır.
API anahtarını tarayıcıdan çağırabilir miyim?
Önerilmez. Anahtar tek başına mağazanızda stok ve fiyat değiştirme yetkisi verir; tarayıcıya gönderilen değeri herkes görebilir. İstekleri yalnız sunucu tarafından atın.
Kaynaklar
İlgili Çiçeksepeti API konuları
Son güncelleme: 27.10.2026 · Çiçeksepeti API rehberinin tamamı