Ortam adresleri
| Ortam | Servis | Dokümandaki örnek adres | IP yetkisi |
|---|---|---|---|
| Canlı | PIM (ürün, stok, fiyat) | https://merchantapi.idefix.com/pim/product-category | Gerekmez |
| Canlı | OMS (sipariş, iade) | https://merchantapi.idefix.com/oms/{vendorId}/list | Gerekmez |
| Test | PIM | https://ide-pimapi.idefiks.net/api/connector/product-category | Gerekir |
| Test | OMS | https://ide-omsapi.idefiks.net/api/shipment/connect/{vendorID}/claim-list | Gerekir |
Canlıda iki servis grubu aynı alan adındadır ve yol /pim ya da /oms ile ayrılır. Testte alan adları ayrıdır ve yol öneki de farklıdır: PIM için /api/connector, OMS için /api/shipment/connect. Canlı yolu test alan adına olduğu gibi eklemeyin. Doküman test için her gruptan yalnız birer örnek desen verir; diğer yolları idefix destek ekibiyle teyit edin.
Test ortamına erişim adımları
- 1. adım: Sunucunuzun çıkış IP adresini idefix'e iletin ve yetki tanımı isteyin.
- 2. adım: idefix test hesaplarını tanımlar ve sizinle paylaşır.
- 3. adım: Test hesabıyla satıcı panelinde Hesap Bilgilerim altındaki Entegrasyon Bilgileri sayfasından test API bilgilerini alın.
idefix testlerin önce stage ortamda tamamlanmasını, sonra canlıya geçilmesini ister. Hem testte hem canlıda erişim sorunu yaşarsanız size iletilen destek e-postası üzerinden idefix'e yazabilirsiniz.
Test ortamında denemeniz gereken akışlar şunlardır: kategori ve marka okuma, bir ürünü create ile gönderip batch-result ile sonucunu okuma, stok ve fiyat gönderip inventory-result ile kontrol etme, sipariş listesini çekme. Bu dört akış hatasız çalışınca canlıya geçmek güvenlidir. Kendi yazılımınızı değil hazır bir entegrasyon kullanıyorsanız test ortamına ihtiyacınız olmaz; canlı bilgileri girmeniz yeterlidir.
Canlı ile test arasında neler değişir?
| Konu | Canlı | Test |
|---|---|---|
| Alan adı | merchantapi.idefix.com | ide-pimapi.idefiks.net ve ide-omsapi.idefiks.net |
| IP yetkisi | Yok | Zorunlu |
| API Key, API Secret, Satıcı ID | Canlı hesaba ait | Test hesabına ait, farklı değerler |
| Hesap | Gerçek mağazanız | idefix'in açtığı test hesabı |
| Kimlik yöntemi | X-API-KEY | X-API-KEY, test bilgileriyle |
Test ortamında açtığınız ürün ya da gönderdiğiniz stok gerçek vitrine çıkmaz. Canlıda ise her istek gerçek mağazanızı etkiler: deneme amaçlı açılan ürün katalog incelemesine girer, yanlış stok gerçek satışa yol açar.
Sık hatalar ve çözümleri
- Test bilgisini canlı adreste kullanmak: kimlik reddedilir. Her ortamın bilgisini kendi hesabından alın.
- Yetkisiz IP'den test adresine istek atmak: erişim sağlanamaz. Bulut sunucularda çıkış IP'si değişebilir; yetkilendirilen IP ile isteği gönderen IP aynı olmalıdır.
- Canlı yol önekini test alan adına eklemek: test yolları /api/connector ve /api/shipment/connect ile başlar.
- Canlıya geçerken adresi değiştirip anahtarı değiştirmeyi unutmak: canlı için ayrı oluşturulan bilgileri girin.
- Deneme ürünlerini canlıda açmak: önce testte deneyin, canlıda az sayıda gerçek ürünle başlayın.
Kimlik başlığının iki ortamda da aynı yöntemle üretildiğini kimlik doğrulama sayfasında görebilirsiniz.
Sık sorulanlar
idefix API'nin canlı adresi nedir?
https://merchantapi.idefix.com. Ürün, stok ve fiyat servisleri /pim, sipariş ve iade servisleri /oms ile başlar.
idefix test ortamı var mı?
Evet. Test ortamı ide-pimapi.idefiks.net ve ide-omsapi.idefiks.net adreslerindedir. Erişim için IP yetkilendirmesi ve idefix'in açtığı test hesabı gerekir.
Canlı ortamda IP adresimi bildirmem gerekir mi?
Hayır. idefix dokümanına göre canlı ortamda IP yetkilendirmesine gerek yoktur.
Test ve canlıda aynı API Key kullanılır mı?
Hayır. API Key, API Secret ve Satıcı ID iki ortamda farklıdır. Her ortamın bilgisini kendi hesabından alın.
Kaynaklar
İlgili idefix API konuları
Son güncelleme: 27.10.2026 · idefix API rehberinin tamamı