V1

Bulbulustur API servislerini kullanabilmek için öncelikle Bulbulustur B2C platformunda bir iş ortağı hesabına sahip olmanız gerekir. Henüz hesabınız bulunmuyorsa Bulbulustur üzerinden iş ortaklığı başvurunuzu oluşturun. Kayıt işleminin ardından kullanıcı paneliniz üzerinden şirket ve mağaza bilgilerinizi tamamlayabilirsiniz. API erişimi, uygun bir iş ortağı hesabı ve gerekli onay işlemleri tamamlandıktan sonra kullanılabilir.

B2C iş ortağı hesabınızın gerekli onay süreçlerinden geçmiş olması gerekir. Kullanıcı panelinizde aşağıdaki bilgileri tamamlayın: • Şirket ve vergi bilgileri • Vergi levhası • İmza sirküleri • Şirket yetkilisi veya hesap sahibi bilgileri • Gerekli sözleşmelerin kabulü • Mağaza bilgilerinin tamamlanması Başvurunuzun değerlendirilmesini ve gerekli onayların tamamlanmasını bekleyin. Onay durumu ve eksik bilgiler için kullanıcı panelinizi kontrol edin.

Hesabınız API erişimi için uygun duruma geldikten sonra Bulbulustur kullanıcı paneline giriş yapın. Panelde API entegrasyonuna ilişkin bölümü açarak mağazanız için API kimlik bilgilerinizi oluşturun. Entegrasyonda kullanılacak bilgiler: • API Key: API isteğini yapan hesabın veya mağazanın tanımlanmasını sağlar. • API Secret: İsteklerin kimlik doğrulamasında kullanılan gizli bilgidir. Oluşturduğunuz bilgileri güvenli şekilde saklayın. API anahtarınızın hangi mağazaya ait olduğunu kontrol edin. Farklı mağazalar için tanımlanmış kimlik bilgilerini birbirinin yerine kullanmayın.

API Key ve API Secret bilgileri yetkisiz kişilerle paylaşılmamalıdır. Güvenli bir entegrasyon için: • API Secret değerini JavaScript veya herkese açık istemci kodlarına yerleştirmeyin. • Anahtarları Git repository içerisine kaydetmeyin. • Kimlik bilgilerini sunucu tarafında güvenli yapılandırma veya secret yönetim sistemi üzerinden kullanın. • Anahtarları uygulama loglarında görüntülemeyin. • Anahtarın bağlı olduğu mağaza hesabını doğrulayın. • Yetkisiz erişim şüphesinde ilgili kimlik bilgilerini yenileyin veya geçersiz kılın. Bulbulustur API isteklerinde X-Api-Key ve X-Api-Secret HTTP başlıkları kullanılır. API anahtarının mağaza ile ilişkili olması nedeniyle erişim işlemleri ilgili mağazanın yetkileri kapsamında değerlendirilir.

Hesabınız onaylandıktan ve API kimlik bilgilerinizi oluşturduktan sonra ilk bağlantı testinizi gerçekleştirebilirsiniz. İlk isteğinizde aşağıdaki HTTP başlıklarını kullanın: X-Api-Key: YOUR_API_KEY X-Api-Secret: YOUR_API_SECRET Accept: application/json İlk test için API Referansı bölümünde belgelenmiş bir GET endpoint seçin. İsteğin sonucunu kontrol edin: • Kimlik doğrulaması başarılı mı? • Doğru mağazanın verilerine erişiliyor mu? • Yanıt beklenen veri biçiminde mi? • Hata durumunda dönen HTTP durum kodu ve hata açıklaması nedir? Üretim ortamında veri değiştiren işlemlere başlamadan önce okuma istekleriyle bağlantıyı doğrulamanız önerilir.

API entegrasyonunu geliştirmeye başlamadan önce aşağıdaki işlemlerin tamamlandığından emin olun. ☐ Bulbulustur B2C iş ortağı hesabı oluşturuldu. ☐ Şirket ve mağaza bilgileri tamamlandı. ☐ Gerekli hesap ve mağaza onayları alındı. ☐ Kullanıcı panelinden API kimlik bilgileri oluşturuldu. ☐ API Key ve API Secret güvenli biçimde saklandı. ☐ API kimlik bilgilerinin doğru mağazaya ait olduğu doğrulandı. ☐ İlk GET isteği başarıyla gerçekleştirildi. ☐ API Referansı ve ilgili entegrasyon dokümantasyonu incelendi. Bu adımları tamamladıktan sonra ürün, sipariş, mağaza ve diğer API entegrasyonlarını geliştirmeye başlayabilirsiniz.