Ön Hazırlıklar · Bulbulustur Developers

B2C İş Ortağı Hesabı

Bulbulustur API entegrasyonu için ilk adım

Bulbulustur public mağaza API'sine erişim için şirket ve mağaza kaydı gerekir. Entegrasyon işlemleri, API anahtarının bağlı olduğu StoreId kapsamında yürütülür.

Ön koşullar

İş ortağı hesabınızı oluşturun; şirket ve mağaza bilgilerinizi tamamlayın. Mağazanın ve API erişiminin etkin olduğundan emin olun. Bu adımlar HTTP API üzerinden yapılan kayıt işlemleri değildir.

Teknik ekip için gerekli bilgiler: mağaza kimliği, mağaza API anahtarı, API Secret, izin verilen IP'ler ve gerekli erişim kapsamları.

Hesap ve Mağaza Onayı

API erişiminden önce gerekli hesap işlemleri

Kimlik bilgilerinin doğrulanabilmesi için API kaydının etkin olması ve geçerli bir mağazaya bağlı bulunması gerekir. Middleware, mağaza ilişkisinin geçerli olup olmadığını kontrol eder.

Erişim sorunları

API erişimi reddedilirse mağaza kimliği, anahtarın etkinliği/geçerliliği, IP izinleri ve kapsamlar kontrol edilmelidir. Başarılı giriş, bütün endpointlerde her işlemin yetkili olduğu anlamına gelmez.

Kimlik Doğrulama bölümünde durum kodları açıklanır.

API Anahtarının Oluşturulması

Kullanıcı panelinden entegrasyon kimlik bilgilerini alın

Mağazaya bağlı API kaydı, X-Api-Key ve X-Api-Secret değerlerini içerir. Bu iki bilgi geliştiriciye güvenli yoldan iletilmeli ve sunucu tarafında saklanmalıdır.

API kimliği

API Key ile API Secret ayrı değerlerdir. HMAC, JWT veya OAuth tokenı oluşturma adımı yoktur. Her API isteğinde bu iki header kullanılır.

Anahtar üretimi için public V1 endpoint doğrulanmadığından bu sayfada hayalî bir anahtar oluşturma API'si belgelenmez. Anahtar yönetimini yetkili mağaza yönetim iş akışından gerçekleştirin.

API Erişimi ve Güvenlik

Entegrasyon kimlik bilgilerinizi koruyun

Her istekte gerekli HTTP başlıkları

X-Api-Keystring · Zorunlu

Mağaza API anahtarı.

X-Api-Secretstring · Zorunlu

Gizli anahtar değeri.

Yalnız HTTPS kullanın. Anahtarları istemci tarayıcısına, kod deposuna veya loglara yazmayın. API kaydında izin verilen IP'ler veya API kapsamları tanımlanmışsa bunlar da erişimi etkiler.

Genel API'nin fixed politikası dakikada 120 istek/IP; kimlik doğrulama testi dakikada 20 istek/IP sınırına sahiptir. İstek Limitleri.

cURLKimlik bilgisi kontrolü

curl --request POST \
  'https://developers.bulbulustur.com/api/Credential/authenticate' \
  --header 'X-Api-Key: YOUR_API_KEY' \
  --header 'X-Api-Secret: YOUR_API_SECRET' \
  --header 'Accept: application/json'

İlk API İsteği

API bağlantınızı doğrulayın

İlk entegrasyon kontrolü için salt okunur GET /api/store endpointini kullanın. Dönen mağaza kimliğinin beklediğiniz mağazaya ait olduğunu doğrulayın.

İşlem

İsteği API Key ve Secret header'larıyla gönderin. Başarılı yanıtın data bölümündeki mağaza alanlarını inceleyin. Kimlik doğrulama hatalarında 401 veya 403 alınabilir; kaynak bulunamazsa 404 dönebilir.

API anahtarındaki IsSandbox bilgisi test verisi akışını belirler. URL'ye sandbox parametresi eklemeyin.

cURLGET /api/store

curl --request GET \
  'https://developers.bulbulustur.com/api/store' \
  --header 'X-Api-Key: YOUR_API_KEY' \
  --header 'X-Api-Secret: YOUR_API_SECRET' \
  --header 'Accept: application/json'

Gerçek yanıt modeli için Mağaza Bilgisi sayfasına bakın.

Entegrasyona Hazırlık Kontrolü

Geliştirmeye başlamadan önce son kontroller

İlk üretim veri çağrısından önce mağaza bağlantısını ve hata yönetimini doğrulayın.

Kontrol listesi

Mağaza ve şirket bilgilerinin tamamlandığını doğrulayın.
API Key ve API Secret'ın doğru mağazaya bağlı olduğunu kontrol edin.
Varsa IP izinlerini ve API kapsamlarını doğrulayın.
POST /api/Credential/authenticate çağrısının sonucunu kontrol edin.
GET /api/store ile mağaza kimliğini doğrulayın.
Sandbox anahtarıyla örnek verilerin gerçek kayıtlarla karıştırılmadığını doğrulayın.
429 ve geçici 5xx hatalarında kontrollü yeniden deneme uygulayın.

Devam etmek için Canlı ve Test Ortamları, Hata Kodları ve Ürün Listesi sayfalarını inceleyin.