Üç bilgi ne işe yarar?
idefix entegrasyonu üç değerle çalışır. İkisi gizli anahtardır, biri mağazanızın numarasıdır. Aşağıdaki örnek değerler sahtedir; kendi değerlerinizi kimseyle paylaşmayın.
| Bilgi | Görevi | İstekte nerede kullanılır | Örnek (sahte) |
|---|---|---|---|
| Satıcı ID (vendorId) | Mağazanızın idefix'teki numarası | Servis yolunda, ör. /pim/pool/{vendorId}/list | SATICI_ID |
| API Key | Kimlik doğrulamanın ilk parçası | X-API-KEY başlığındaki kodlanmış değerin başında | API_KEY |
| API Secret | Kimlik doğrulamanın ikinci parçası | Aynı başlıkta, API Key'den sonra | API_SECRET |
API Key ve API Secret tireli uzun kodlardır. idefix dokümanındaki örnek, sekiz-dört-dört-dört-on iki karakterlik UUID biçimini gösterir. Satıcı ID ise yalnız rakamlardan oluşur. Üç değer birlikte kullanılır; biri yanlışsa hiçbir servis çalışmaz.
Adım adım API bilgisi oluşturma
- idefix satıcı paneline girin: satici.idefix.com.
- Hesap Bilgilerim menüsünü açın ve Entegrasyon Bilgileri sayfasına geçin.
- Yeni API Oluştur düğmesine basın.
- API Key ve API Secret, sistemde kayıtlı e-posta adresinize gönderilir. E-postayı gelen kutusunda ve istenmeyen klasöründe arayın.
- Satıcı ID'nizi aynı Entegrasyon Bilgileri sayfasından not edin.
idefix dokümanı iki anahtarın da e-postayla geldiğini söyler. Canlı kullanımda e-postadaki değerlerin "Token" ve "Secret" adıyla geldiği görüldü. Bu durumda Token değeri API Key, Secret değeri API Secret'tır. Menü adları zamanla değişebilir; güncel adımı idefix API portalındaki Authorization sayfasından kontrol edin.
Canlı ve test bilgileri ayrıdır
idefix canlı (prod) ve test (stage) ortamı için farklı API Key, API Secret ve Satıcı ID verir. Test ortamına girmek için önce sunucunuzun IP adresi idefix tarafından yetkilendirilir, sonra test hesabı açılıp sizinle paylaşılır. Canlı ortamda IP yetkisi gerekmez.
Test bilgisiyle canlı adrese istek atarsanız kimlik reddedilir. Hangi adresin hangi ortama ait olduğu canlı ve test ortamı sayfasında anlatılıyor.
Güvenli saklama
- idefix'in kendi uyarısı: API bilgileriyle tüm entegrasyon işlemleri yapılabilir; bu bilgileri herkese açık hiçbir yerde paylaşmayın.
- Anahtarı tarayıcıda çalışan koda, mobil uygulamaya ya da herkese açık bir kod deposuna koymayın.
- Kayıt (log) dosyalarına X-API-KEY başlığını yazmayın; hata ayıklarken değeri maskeleyin.
- Anahtarı verdiğiniz yazılım mağazanız adına ürün açabilir, stok değiştirebilir, siparişe bildirim yapabilir. Yalnız güvendiğiniz entegrasyona verin.
- Sızıntı şüphesinde panelden yeni API bilgisi oluşturun ve bağlı tüm yazılımlardaki değeri güncelleyin.
API anahtarının ne olduğunu teknik olmayan bir dille merak ediyorsanız pazaryeri API anahtarı nedir yazısına bakın.
Sık hatalar ve çözümleri
| Belirti | Olası neden | Çözüm |
|---|---|---|
| 401 ve VENDOR_TOKEN_NOT_EXIST | Key ile Secret yer değiştirmiş ya da biri eksik kopyalanmış | E-postadaki Token'ı API Key, Secret'ı API Secret alanına yapıştırın |
| API Key alanında e-posta adresi görünüyor | Tarayıcı alanı otomatik doldurmuş | Alanı temizleyip tireli kodu yapıştırın |
| Değer doğru görünüyor ama 401 | Başta ya da sonda boşluk kalmış | Kopyaladığınız değerin iki ucunu kontrol edin |
| Testte çalışan bilgi canlıda 401 alıyor | Stage bilgisi canlı adreste kullanılmış | Canlı hesap için ayrı oluşturulan bilgileri girin |
| Satıcı ID'de harf ya da boşluk var | Kopyalama hatası | Satıcı ID yalnız rakamdan oluşur; yeniden kopyalayın |
Kimlik başlığının nasıl üretildiği X-API-KEY ile kimlik doğrulama sayfasında, tüm hata kodları hata kodları sayfasında.
Sık sorulanlar
idefix API Key nereden alınır?
Satıcı panelinde Hesap Bilgilerim altındaki Entegrasyon Bilgileri sayfasında Yeni API Oluştur düğmesine basın. API Key ve API Secret, idefix'te kayıtlı e-posta adresinize gönderilir.
idefix Satıcı ID nedir?
Mağazanızın idefix'teki sayısal numarasıdır. Servis adreslerinde {vendorId} olarak geçer ve Entegrasyon Bilgileri sayfasında görünür.
E-postadaki Token hangi alana yazılır?
Token değeri API Key, Secret değeri API Secret alanına yazılır. İkisi yer değiştirirse idefix 401 durumu ve VENDOR_TOKEN_NOT_EXIST mesajı döndürür.
API bilgisi için idefix'e ayrıca başvurmak gerekir mi?
Canlı ortam için panelden oluşturmanız yeterlidir. Test ortamı için IP yetkilendirmesi ve test hesabı idefix tarafından tanımlanır.
Kaynaklar
İlgili idefix API konuları
Son güncelleme: 27.10.2026 · idefix API rehberinin tamamı