Bulbulustur Geliştirici

Canlı ve Test Ortamları V1

Test ve canlı ortamlar, entegrasyon geliştirme ile üretim işlemlerini birbirinden ayırmak için kullanılır. Geçerli servis adreslerini, ortam kimlik bilgilerini ve canlıya geçiş koşullarını kullanmadan önce doğrulayın.

Ortam ve Adres Yapısı

Tek API adresi · Anahtara göre ortam

Bulbulustur public API'de test ile canlı işlem seçimi, doğrulanan mağaza API anahtarının IsSandbox durumuna bağlıdır. Kodda doğrulanan ayırım, farklı bir URL seçmeye değil, aynı API üzerinde kimlik bilgisinin sandbox niteliğine dayanır.

İstek adresi

Dokümantasyonda kullanılan public API yolu örneği: https://developers.bulbulustur.com/api/store. Gerçek dağıtımda kullanılacak domain ve erişilebilirlik dağıtım yapılandırmasıyla doğrulanmalıdır.

Uyarı

https://test-api.bulbulustur.com, https://test.bulbulustur.com/dev_api veya https://api.bulbulustur.com adresleri çalışan ve desteklenen public servis URL'leri olarak doğrulanmadığından burada kesin endpoint olarak yayımlanmıyor.

Sandbox Kimlik Bilgileri

IsSandbox · API Key / API Secret

Her istek X-Api-Key ve X-Api-Secret header'larıyla doğrulanır. Middleware mağaza API kaydından IsSandbox bilgisini alarak oturum taleplerine ekler. İstek sırasında sandbox seçmek için ayrı bir query parametresi veya özel bir ortam header'ı kullanılmaz.

Sandbox göstergesi

Sandbox anahtarı kullanıldığında başarılı kimlik doğrulama akışında yanıt header'ına X-Bulbulustur-Sandbox: true eklenir. Bu header, o yanıtın sandbox niteliğini doğrulamak için kullanılabilir.

Test ve canlı anahtarları birbirinin yerine kullanılmamalıdır. Mevcut mimaride ortam seçimi için JWT, OAuth tokenı veya HMAC imzası bulunmaz. Kimlik Doğrulama bölümüne bakın.

Test Verisi ve Kapsam

Ürün · Sipariş · İade · Mağaza

Mevcut sandbox implementasyonunda GET /api/store, GET /api/products, GET /api/orders ve GET /api/returns gibi endpointler, sandbox anahtarıyla çağrıldığında örnek veri sağlayan SandboxData akışını kullanır. Detay endpointleri de ilgili örnek veri setinden yanıt döndürebilir.

Test verisini yorumlama

Sandbox verileri gerçek sipariş, ürün veya iade kaydı olarak ele alınmamalı; testte alınan ID'lerin canlı ortamda var olduğu varsayılmamalıdır. Yeni eklenen tüm referans endpointlerinin sandbox verisiyle çalıştığı garanti değildir; bazıları mevcut Globalization veya kategori servisinden veri okumaktadır.

İlgili endpointlerin gerçek yanıt sözleşmeleri için Ürün Listesi ve Sipariş Listesi sayfalarına bakın.

Canlı Ortama Geçiş

Kimlik doğrulama · Entegrasyon kontrolü

Canlı işleme geçmeden önce canlı mağazaya bağlı ve sandbox işareti kapalı API kimlik bilgilerini kullanın. Sandbox anahtarını canlı istek için yeniden kullanmayın.

Doğrulama kontrolü

1. Canlı API Key / API Secret değerleriyle POST /api/Credential/authenticate çağırın. 2. Başarılı yanıttaki storeId ve apiScope değerlerini doğrulayın. 3. GET /api/store ile beklenen mağaza kimliğini karşılaştırın. 4. İstek limiti, hata yönetimi ve yeniden deneme davranışını kontrol edin. 5. Üretim verisi kullanmadan önce ilgili endpointlerin yetkilerini doğrulayın.

Test verilerinin canlı ortama otomatik taşındığı veya sandbox testlerinin üretim kayıtları oluşturduğu varsayılmamalıdır.