Kimlik doğrulama
idefix API'de token ayrı bir servisten alınmaz. Her istekte X-API-KEY başlığı gönderilir; değeri base64(API_KEY:API_SECRET) formülüyle üretilir. API Key ve API Secret, satıcı panelinde Hesap Bilgilerim altındaki Entegrasyon Bilgileri sayfasında Yeni API Oluştur düğmesine basılınca e-postanıza gelir.
Satıcı ID başlıkta değil, servis yolunda {vendorId} olarak geçer. Kimlik yanlışsa yanıt 401 ve VENDOR_TOKEN_NOT_EXIST olur. Ayrıntılar: API bilgilerini alma ve X-API-KEY ile kimlik doğrulama.
Ortamlar ve temel adres
| Ortam | Adres | Erişim |
|---|---|---|
| Canlı | https://merchantapi.idefix.com | IP yetkisi gerekmez |
| Test (PIM) | https://ide-pimapi.idefiks.net | IP yetkisi ve test hesabı gerekir |
| Test (OMS) | https://ide-omsapi.idefiks.net | IP yetkisi ve test hesabı gerekir |
Canlıda ürün, katalog, stok ve fiyat servisleri /pim, sipariş, kargo ve iade servisleri /oms ile başlar. Test ve canlı ortamın API bilgileri farklıdır. Ayrıntı: canlı ve test ortamı.
İstek sınırları
idefix sabit bir sayı yayımlamaz. Eşik aşılınca 429 Too Many Request döner; X-Api-Call-Limit başlığı saniyedeki istek sayısını, Retry-After başlığı beklenecek saniyeyi (örnekte 2.0) bildirir. Bir ürün oluşturma isteğinde en fazla 200 ürün gönderilir. Ayrıntı: istek sınırı ve 429.
Ürün akışı ve sınırlar
Katalogda barkodu olan ürün fast-listing ile kategori ve marka girmeden listelenir; olmayan ürün create ile açılır. İki işlem de batchRequestId döndürür ve sonuç ayrı servisten okunur. Katalogla eşleşen ürün waiting_vendor_approve durumunda onayınızı bekler.
API ile ürün bilgisi güncellenemez; yalnız stok ve fiyat inventory-upload servisiyle değişir. Güncel stok ve fiyat inventory/list servisinden okunur; ürün listesindeki stok alanı bu iş için güvenilir değildir.
Genel hata kodları
| Kod | Anlamı |
|---|---|
| 401 VENDOR_TOKEN_NOT_EXIST | Kimlik yanlış, sırası ters ya da başka ortama ait |
| 429 | İstek sınırı aşıldı; Retry-After kadar bekleyin |
| 400 ve violations | Gövdede doğrulamadan geçmeyen alan var (canlı kullanımda görüldü) |
| 405 | Yanlış HTTP yöntemi (canlı kullanımda görüldü) |
Toplu işlemlerde kalem bazında failureReasons kodları döner; örneğin CATEGORY_MANDATORY_ATTRIBUTE_MISSED, PRODUCT_BARCODE_NOT_EXIST, PRODUCT_NOT_FOUND. Tam liste: hata kodları.
idefix API işlemleri
Genel
Ürün ve katalog
Stok ve fiyat
Sipariş
Sık sorulanlar
idefix API dokümanı nerede?
Resmî doküman developer.idefix.com adresindedir. Başlangıç, Authorization, canlı-test ortam bilgileri, ürün, sipariş ve soru-cevap entegrasyonu sayfaları ile sıkça sorulan sorular burada yer alır.
idefix API'nin temel adresi nedir?
Canlı ortamın adresi https://merchantapi.idefix.com'dur. Test ortamı ürün servisleri için ide-pimapi.idefiks.net, sipariş servisleri için ide-omsapi.idefiks.net adreslerini kullanır.
idefix API ile hangi işlemler yapılabilir?
Kategori, marka ve kargo bilgisi okuma; hızlı listeleme ve ürün oluşturma; eşleşme onayı; stok ve fiyat güncelleme; sevkiyatları çekme, statü, fatura linki ve kargo bildirimi; tedarik edilemedi ve bölme; iade onayı ve ret talebi; müşteri ve sipariş sorularını yanıtlama.
idefix API'de ürün bilgisi güncellenebilir mi?
Hayır. idefix dokümanına göre API ile yalnız stok ve fiyat güncellenir. Ad, açıklama ve görsel gibi bilgiler API dışında değiştirilir.
idefix entegrasyonu için hazır bir yazılım kullanabilir miyim?
Evet. Kendi yazılımınızı geliştirmek yerine bir entegrasyon yazılımına Satıcı ID, API Key ve API Secret'ı girerek bağlanabilirsiniz; idefix entegrasyonu sayfası bu yolu anlatır.