Ne işe yarar?
Harici sistemlerin FastEntegre API’sine güvenli erişimi.
Neden önemli?
Sızan anahtar tüm mağaza verisine risk oluşturur.
Detaylı açıklama
Uzun süren toplu işlemler senkron HTTP isteğiyle yapılmamalı; backend görev kuyruğunu kullanın. Rate limit (429) alındığında istek hızını düşürün.
Harici sistemler FastEntegre’ye Bearer (API v2) veya (eski) Basic ile bağlanır. Anahtar panel şifresi değildir; sızması sipariş/ürün okuma-yazma riski taşır. Yalnızca sunucu tarafında saklayın; git, tarayıcı, mobil uygulama ve ekran görüntüsüne koymayın. Personel çıkışında rotate edin. Mümkünse IP kısıtı uygulayın.
Ön koşullar
- API erişimi açılmış hesap tipi.
- Sunucu tarafında güvenli anahtar saklama.
Adımlar (Menü > Ayarlar > API (hesap tipinize göre))
- Anahtarı yalnızca sunucu tarafında saklayın.
- Mümkünse IP kısıtı uygulayın.
- Personel değişiminde anahtarı yenileyin.
- Git deposuna anahtar koymayın.
- Menü > Ayarlar > API (hesap tipinize göre) anahtar üretin.
- Değeri bir kez kopyalayıp gizli kasa/CI secret’a koyun; tekrar gösterilmeyebilir.
- IP allowlist varsa yalnızca sunucu IP’sini yazın.
- Şüphede eski anahtarı iptal edip yenisini dağıtın.
Webhook vs API anahtarı
Platform webhook’ları ayrı imza/token kullanır. FastEntegre API anahtarını pazaryeri formuna yapıştırmayın. Tersi de geçerli: Trendyol secret’ı FastEntegre API v2’ye koyulmaz.
Sık karşılaşılan hatalar
- 401 Unauthorized — Yanlış veya süresi dolmuş anahtar; rotate edin.
- 401 Unauthorized — Yanlış veya iptal anahtar. Header
Authorization: Bearer …boşluksuz olmalı. - Anahtar git’te bulundu — Hemen rotate + git geçmişinden temizleme. Panel şifresini de değiştirin.
Sık sorulan sorular
Birden fazla anahtar?
Hesap tipine göre. Entegrasyon başına ayrı anahtar blast radius’u küçültür.
Rate limit?
Toplu iş limitleri. 429’da yavaşlayın.
İlgili rehberler
Hâlâ çözülmedi?
- Destek talebi açın — kısa başlık, ana mağaza ID, mağaza adı, ekran görüntüsü ve tam hata metnini ekleyin.
- WhatsApp: 0850 242 32 78 (mesai saatleri içinde yanıt verilir).
- Sipariş veya fatura tamamen durduysa Acil: sipariş veya fatura kesilemiyor makalesindeki kontrol listesini uygulayın.