Vendor token nasıl üretilir?
- API Key ve API Secret değerlerini alın.
- Aralarına iki nokta koyarak birleştirin: API_KEY:API_SECRET.
- Bu metni Base64 ile kodlayın.
- Sonucu her isteğin X-API-KEY başlığına yazın.
idefix dokümanı formülü şöyle verir: VENDOR TOKEN = base64_encode(ApiKEY:ApiSecret). Kodlama şifreleme değildir; Base64 metni herkes geri çözebilir. Bu yüzden istekler yalnız HTTPS ile gönderilmelidir. Base64'ün ne olduğunu MDN Base64 sayfası anlatır.
Token bir kez hesaplanır ve değişmez; her istekte yeniden üretmeniz gerekmez. Uygulama açılırken hesaplayıp bellekte tutmak yeterlidir. Anahtarları panelden yenilediğinizde token da değişir; o zaman değeri yeniden hesaplayın.
İstek başlıkları
| Başlık | Değer | Not |
|---|---|---|
| X-API-KEY | base64(API_KEY:API_SECRET) | Zorunlu; dokümanda API key tipinde başlık olarak tanımlı |
| Content-Type | application/json | JSON gövdeli POST isteklerinde |
| Accept | application/json | Yanıtı JSON almak için |
idefix dokümanı kimliği yalnız X-API-KEY başlığında tarif eder. Trendyol ya da Hepsiburada'dan alışkanlıkla Authorization: Basic başlığı yazmayın; idefix'te Basic Auth tarif edilmez. İki başlığı aynı anda göndermek de hata ayıklamayı zorlaştırır.
Satıcı ID başlıkta değil, yolda
Token yalnız kimliği doğrular. Hangi mağazanın verisinin istendiği, servis yolundaki {vendorId} parçasından anlaşılır. Bazı servisler satıcıdan bağımsızdır ve yolda Satıcı ID taşımaz.
| Servis grubu | Örnek yol | Satıcı ID |
|---|---|---|
| Ürün havuzu (PIM) | /pim/pool/{vendorId}/create | Yolda |
| Katalog, stok ve fiyat | /pim/catalog/{vendorId}/inventory-upload | Yolda |
| Sipariş (OMS) | /oms/{vendorId}/list | Yolda ve zorunlu vendor parametresinde |
| Kategori ve marka | /pim/product-category, /pim/brand | Yok |
Key ve Secret ters girilince ne olur?
Sıra önemlidir. base64(API_KEY:API_SECRET) ile base64(API_SECRET:API_KEY) tamamen farklı sonuç verir. Ters sırada idefix 401 durumu ve "message": "VENDOR_TOKEN_NOT_EXIST" yanıtı döner.
Bu hata en çok e-postadaki Token ve Secret değerleri karıştırıldığında görülür. İki değer aynı biçimde, tireli UUID olarak geldiği için gözle ayırt etmek zordur. Hangisinin Token olduğunu e-postadaki etiketten okuyun.
Sık hatalar ve çözümleri
| Hata | Neden | Çözüm |
|---|---|---|
| 401 VENDOR_TOKEN_NOT_EXIST | Sıra ters, değer eksik ya da stage bilgisi canlıda | Sırayı ve ortamı kontrol edin |
| Kodlanmış değer hatalı | Satır sonu karakteri ya da boşluk da kodlanmış | Kodlamadan önce iki değeri kırpın |
| Token doğru, yanıt 404 | Yol yanlış ya da {vendorId} boş kalmış | Yolu dokümandakiyle karşılaştırın |
| Bazı istekler geçiyor, bazıları 401 | Farklı sunucularda farklı anahtar tanımlı | Tüm ortam değişkenlerini güncelleyin |
Kimlik doğruysa ama çok sık istek atıyorsanız 401 değil 429 alırsınız; bunun için istek sınırı sayfasına bakın.
Sık sorulanlar
idefix API'de token süresi dolar mı?
Vendor token, API Key ile API Secret'tan her seferinde aynı şekilde üretilir. Dokümanda ayrı bir süre ya da yenileme adımı yoktur. Panelden yeni API bilgisi oluşturursanız token da değişir.
X-API-KEY başlığına yalnız API Key mi yazılır?
Hayır. Başlığa API Key ile API Secret'ın iki noktayla birleştirilmiş ve Base64 ile kodlanmış hâli yazılır.
VENDOR_TOKEN_NOT_EXIST ne demek?
idefix, gönderilen token'a karşılık gelen bir satıcı bulamadı demektir. Sıra, eksik karakter ve ortam (canlı ya da test) en sık nedenlerdir.
Satıcı ID token'ın içine eklenir mi?
Hayır. Token yalnız API Key ve API Secret'tan oluşur. Satıcı ID servis yolunda {vendorId} olarak geçer.
Kaynaklar
İlgili idefix API konuları
Son güncelleme: 27.10.2026 · idefix API rehberinin tamamı