Anahtarı nereden alırsınız?
API anahtarı satıcı panelindeki entegrasyon bilgileri bölümünde yer alır. Panel menülerinin adı zaman içinde değişebildiği için "API" ya da "Entegrasyon" başlıklı bölümü arayın. Bölümü bulamıyorsanız ya da anahtar hiç üretilmemişse panel içindeki destek kanalından API erişimi talep edin.
| Bilgi | Nerede kullanılır | Not |
|---|---|---|
| API anahtarı | Her istekte x-api-key başlığı | Gizli tutulmalı |
| Satıcı numarası | Bazı entegrasyon yazılımlarının formunda | Mağaza kimliğini kayıt altına almak için |
| User-Agent değeri | İsteğe bağlı HTTP başlığı | Bazı mağazalara özel bir değer iletilebiliyor |
Örneklerde gerçek değer yerine API_KEY ve SATICI_ID gibi yer tutucular kullanın.
İlk test: ürün listeleme isteği
Anahtarın çalıştığını en güvenli şekilde bir okuma isteğiyle anlarsınız. GET https://apis.ciceksepeti.com/api/v1/Products adresine Page=1 ve PageSize=1 parametreleriyle istek atın, başlığa x-api-key ekleyin.
- Yanıt 200 ise ve totalCount alanı geliyorsa anahtar doğrudur. Mağazada ürün yoksa totalCount sıfır olabilir.
- 401 ya da 403 benzeri bir yanıt anahtarın yanlış ya da eksik olduğunu düşündürür.
- "Limit aşımı" mesajı anahtarın çalıştığını ama aynı isteği kısa sürede tekrarladığınızı gösterir. Bir süre bekleyin.
Test için yazma işlemi yapan servisleri (ürün yükleme, stok güncelleme) kullanmayın; yanlış bir değer canlı mağazanızı etkiler.
Güvenli saklama
Çiçeksepeti'de kimlik doğrulama yalnız bu anahtara dayanır. Anahtarı ele geçiren biri stok ve fiyatlarınızı değiştirebilir. Bu yüzden:
- Anahtarı kod deposunda, ekran görüntülerinde ve destek yazışmalarında açık bırakmayın.
- Sunucu tarafında şifreli saklayın; tarayıcıya ya da mobil uygulamaya göndermeyin.
- Anahtarın sızdığını düşünüyorsanız panelden ya da destek kanalından yenilenmesini isteyin ve bütün yazılımlara yeni değeri girin.
- Anahtarı kullanan yazılımların listesini tutun. Anahtar değiştiğinde hangisini güncelleyeceğinizi bilirsiniz.
Sık yapılan hatalar
- Boşluklu kopyalama: Panelden kopyalarken baştaki ya da sondaki boşluk anahtarın parçası gibi gider. Değeri kırpın.
- Başlık adını yanlış yazmak: Başlık adı x-api-key olmalıdır. Authorization başlığına yazılan anahtar okunmaz.
- Testi art arda tekrarlamak: Ürün listesinde aynı isteğin kısa sürede tekrarı limit mesajı üretir; bu bir yetki hatası değildir.
- Satıcı numarasını anahtar sanmak: Satıcı numarası mağazanın kimliğidir, gizli anahtar değildir. İstekler anahtarla doğrulanır.
Sık sorulanlar
Çiçeksepeti API key nereden alınır?
Çiçeksepeti Pazaryeri satıcı panelindeki (seller.ciceksepeti.com) entegrasyon bilgileri bölümünden. Anahtar üretilmemişse panel içindeki destek kanalından API erişimi talep edebilirsiniz.
Çiçeksepeti API'de şifre ya da secret var mı?
Çalışan entegrasyonlarda isteklerin doğrulanması yalnız API anahtarıyla, x-api-key başlığıyla yapılıyor. Ayrı bir secret ya da token adımı kullanılmıyor.
API anahtarım çalışıyor mu, nasıl anlarım?
GET /api/v1/Products isteğini Page=1 ve PageSize=1 ile gönderin. 200 yanıtı ve totalCount alanı geliyorsa anahtar çalışıyordur.
Satıcı ID'yi istekte göndermem gerekir mi?
Çalışan bir entegrasyonun kodunda ürün, stok ve sipariş istekleri satıcı numarası gönderilmeden, yalnız anahtarla yapılıyor. Mağaza, anahtardan tanınıyor.
API anahtarı değişirse ne yapmalıyım?
Yeni anahtarı, eski anahtarı kullanan bütün yazılımlara aynı anda girin. Geçiş sırasında stok ve sipariş akışı kesilebileceği için değişikliği yoğun satış saatlerinin dışında yapın.
Kaynaklar
İlgili Çiçeksepeti API konuları
Son güncelleme: 27.10.2026 · Çiçeksepeti API rehberinin tamamı