SIT ile canlı ortam arasındaki fark
| Konu | SIT (test) | Canlı |
|---|---|---|
| Amaç | Entegrasyonu denemek, onay almak | Gerçek satış |
| Veri | Test ürünleri ve siparişleri | Mağazanın gerçek verisi |
| Listing adresi | listing-external-sit.hepsiburada.com | listing-external.hepsiburada.com |
| Sipariş adresi | oms-external-sit.hepsiburada.com | oms-external.hepsiburada.com |
| Kimlik | O ortama ait Merchant ID ve servis anahtarı | Canlı mağazanın bilgileri |
Test adresleri kimliksiz bir isteğe canlı adresler gibi 401 ile yanıt verir; yani ayakta olan ayrı servislerdir. Hesabınız için hangi ortamın açık olduğunu ve test bilgilerinizi geliştirici portalında doğrulayın.
Önerilen test planı
Aşağıdaki sıra, en temel işten en karmaşığa doğru ilerler. Her adım bir öncekine dayanır; bir adım başarısızsa sonrakine geçmeyin.
- Kimlik: Listing servisinden tek kayıtlık liste isteyin (limit=1). 200 yanıtı başlıkların doğru olduğunu gösterir.
- Kategori ve özellik: bir yaprak kategori seçip zorunlu özelliklerini çekin.
- Ürün yükleme: bir test ürününü katalog yüklemesiyle gönderin ve takip numarasını alın.
- Yükleme sonucu: takip numarasıyla durumu sorgulayın; hata yoksa ürün incelemeye düşer.
- Stok ve fiyat: bir listeleme için stok güncellemesi gönderin, takip sonucunu okuyun.
- Sipariş: test siparişini listeleyin, detayını çekin, paket akışını deneyin.
Her adımın isteğini ve yanıtını saklayın. Onay sürecinde Hepsiburada'nın sorabileceği takip numaraları bu kayıtlarda durur.
Ortam adresini koddan ayırın
Test ve canlı arasındaki tek fark adresler ve kimlik bilgileri olmalıdır. Kodun geri kalanı aynı kalır. Bunun için üç servis adresini ve kimliği ayar dosyasında ya da ortam değişkeninde tutun.
- Listing, MPOP ve OMS adreslerini ayrı ayarlar olarak tanımlayın.
- Adresleri yalnız https ile başlayan hepsiburada.com alt alan adlarıyla sınırlayın. Böylece yanlış yazılmış bir ayar isteği başka bir sunucuya göndermez.
- Canlı anahtarı test makinesinde tutmayın. İki ortamın bilgilerini karıştırmak, test isteğinin gerçek mağazaya gitmesine yol açar.
Canlıya geçişte kontrol listesi
- Merchant ID ve servis anahtarını canlı değerlerle değiştirin.
- Üç servis adresinden -sit ekini kaldırın.
- User-Agent değerinin canlı entegrasyon adıyla aynı olduğunu kontrol edin.
- İlk stok güncellemesini birkaç ürünle sınırlayın ve takip sonucunu okuyun.
- Webhook adresinizi canlı ortam için yeniden tanımlayın; bildirim akışı webhook sayfasında.
- Stok kaynağınızı belirleyin. Hangi kanalın doğru kabul edileceği stok kaynağı seçimi rehberinde.
Sık hatalar ve çözümleri
| Belirti | Olası neden | Çözüm |
|---|---|---|
| Canlıya geçince 401 | Test kimliği canlı adreste kullanılıyor | Kimliği ve adresleri birlikte değiştirin |
| SIT'te yüklenen ürün canlıda yok | Ortamlar ayrı veritabanlarıdır | Ürünü canlıda yeniden yükleyin |
| Test sırasında gerçek stok değişti | Canlı adres test ayarında kalmış | Ortam ayarlarını ayırın, adresleri doğrulayın |
| Testte çalışan kod canlıda farklı davranıyor | Canlı veride beklenmedik alanlar ya da büyük listeler var | Sayfalamayı ve boş alanları canlıda küçük bir grupla sınayın |
Sık sorulanlar
Hepsiburada SIT ortamı nedir?
Entegrasyonu gerçek mağazaya dokunmadan denemek için ayrılmış test ortamıdır. Adresleri canlı servislerin -sit ekli karşılıklarıdır.
SIT ve canlı için aynı servis anahtarı kullanılır mı?
Her ortamın kendi kimlik bilgileri olur. Hangi bilginin hangi ortamda geçerli olduğunu geliştirici portalında kontrol edin.
Test ortamında yüklediğim ürünler canlıya taşınır mı?
Hayır. İki ortam ayrıdır. Canlıya geçtikten sonra ürünleri canlı kataloğa yeniden göndermeniz gerekir.
Onay için hangi testler gerekir?
Kesin liste geliştirici portalındaki onay adımlarındadır. Ürün yükleyip takip numarası almak ve stok güncellemesi göndermek, sıkça istenen temel işlemlerdir.
Kaynaklar
İlgili Hepsiburada API konuları
Son güncelleme: 27.10.2026 · Hepsiburada API rehberinin tamamı