Gelişmiş ayarlar: API anahtarı, Cloudflare, özel alanlar

- API anahtarı: ERP, muhasebe ya da depo programını mağazana bağlar
- Webhook: sipariş, kargo ya da stok değişince programına haber gider
- Cloudflare: alan adın oradaysa hız ve güvenlik ayarlarını tek tıkla kurar
- Özel alanlar: ürüne, kategoriye, sayfaya ve müşteriye kendi bilgi alanların
- Gelişmiş: vergi oranları, bölgeler ve para birimleri, depolar, özel roller
MultiKolay’ın gelişmiş ayarları dört yerde: ERP ya da muhasebe programını bağlamak için Ayarlar → API anahtarları, alan adın Cloudflare’deyse Uygulamalar → Cloudflare, ürünlere kendi bilgi alanlarını eklemek için Ayarlar → Özel alanlar ve vergi oranları, bölgeler, depolar ile özel roller için Ayarlar → Gelişmiş. Hiçbiri satışa başlamak için şart değildir; işin büyüdükçe gerekir.
API anahtarı ne işe yarar?
API anahtarı, kullandığın bir yazılımın (ERP, muhasebe, depo ya da entegratör programı) mağazana bağlanıp ürün, stok, fiyat ve sipariş bilgisini okumasını ya da yazmasını sağlar. Her anahtar yalnız senin seçtiğin izinlerle çalışır; bir programa yalnız stok okuma izni verebilir, başka birine sipariş yazma izni açabilirsin.
API anahtarı nasıl oluşturulur?
- Ayarlar → API anahtarları’nda Yeni anahtar’a bas.
- Ad alanına anahtarın hangi program için olduğunu yaz, ör. “Muhasebe programı”.
- İzinlerde programın gerçekten ihtiyaç duyduklarını işaretle: Ürünler, Stok, Fiyatlar, Siparişler, Müşteriler, Kampanyalar ve Sayfa ve menüler için Okuma ve Yazma, Webhook için Yönetme. Yazma izni okumayı da kapsar.
- Anahtarı oluştur’a bas. Anahtar yalnız bu anda bir kez gösterilir; kopyalayıp programına yapıştır ve Kaydettim, kapat de.

Listede her anahtarın kısaltması, son kullanım tarihi ve izinleri görünür. Bir programla çalışmayı bıraktığında anahtarını İptal et ile kapatırsın; iptal edilen anahtar hemen çalışmayı bırakır ve “İptal edilenler” altında saklanır. Geliştiricin için uçlar ve örnekler docs.multikolay.com’da; istekler Authorization: Bearer başlığıyla anahtar gönderilerek yapılır.
Webhook nedir?
Aynı sayfadaki Webhook’lar bölümü, mağazanda bir şey olduğunda (sipariş geldi, kargoya verildi, stok değişti) programına anında haber gönderir. Yeni webhook’a basıp programının istekleri karşılayan adresi (https:// ile başlar) yazar ve hangi olaylarda haber gideceğini seçersin. Test gönder ile bir deneme isteği yollar, Son teslimatlar listesinde sonucunu görürsün. Her istek imzalıdır; program isteğin MultiKolay’dan geldiğini doğrulayabilir. Teslim edilemeyen istek bir süre yeniden denenir; program uzun süre cevap vermezse webhook kapanır ve panelde bildirim görürsün.
Cloudflare uygulaması ne yapar?
Alan adın Cloudflare’deyse Uygulamalar → Cloudflare önerilen güvenlik ve hız ayarlarını senin yerine kurar: SSL, her zaman HTTPS, HSTS, HTTP/3 ve Brotli; görseller ve JS/CSS Cloudflare önbelleğinde tutulur, sepet, ödeme, hesap ve panel hiçbir zaman önbelleğe girmez. Panelde değişiklik yaptığında ve her güncellemede önbellek kendiliğinden temizlenir.

- Cloudflare’de, çekmecedeki Token nasıl oluşturulur? bölümünde listelenen izinlerle bir API token oluştur.
- Token’ı API token alanına yapıştır ve Alan adlarını getir’e bas.
- Alan adı listesinden mağazanın alan adını seç, Cloudflare aktif anahtarını açıp Kaydet’e bas.
- Önerilen ayarları uygula ile güvenlik ve hız ayarlarını Cloudflare’e yazdır. Cloudflare’de kendi yazdığın kurallara dokunulmaz.
Aynı çekmecede bütün önbelleği ya da seçtiğin adresleri tek tuşla temizleyebilir, geliştirme modunu açabilir ve son işlemleri görebilirsin. Token şifreli saklanır ve bir daha ekranda gösterilmez. Alan adını henüz bağlamadıysan önce alan adı rehberimize bak; Cloudflare’deki alan adında DNS kayıtlarını orada otomatik açabilirsin.
Özel alanlar nedir?
Özel alanlar, ürünlerine, kategorilerine, sayfalarına ve müşterilerine kendi bilgi alanlarını eklemeni sağlar: malzeme, ölçü, garanti süresi, bakım talimatı, teknik çizim gibi. Temanın desteklediği alanlar sitede de gösterilebilir. Ayarlar → Özel alanlar’da kayıt türünün sekmesini (Ürünler, Kategoriler, Sayfalar, Müşteriler) seçip Alan ekle’ye basarsın.

- Alanın adı: panelde göreceğin ad, ör. “Malzeme”.
- Temadaki adı: temanın alanı okuduğu ad; kendiliğinden önerilir ve sonradan değişmez.
- Ne tür bir bilgi? Tek satır ya da çok satırlı metin, seçenekli metin, sayı, puan, boyut, ağırlık, hacim, tarih, tutar, dosya, bağlantı, renk gibi türlerden birini seçersin.
Alanı kaydettiğinde ürün düzenleme sayfasında Özel alanlar kartı çıkar ve her ürün için değeri oraya yazarsın. Kullandığın tema kendi alanlarını getirdiyse bu alanlar kilitli görünür: adını ve türünü tema belirler, değerlerini sen girersin. Temayı değiştirsen de alanlar ve girdiğin bilgiler yerinde kalır.
Gelişmiş ayarlarda neler var?
Ayarlar → Gelişmiş dört bölümü bir arada tutar. Her satırdaki Aç ile ilgili listeye girersin.

- Vergi: farklı KDV oranlı ürünlerin için oranlar; yurt dışı satışta yüzde 0.
- Bölgeler ve para birimleri: sattığın ülkeler, para birimleri ve bölgenin KDV oranı.
- Depolar: birden fazla yerde stok tutuyorsan stok konumları ve adresleri.
- Özel roller: hazır rollerin dışında, personel için kendi izin setini tanımlarsın. Roller ekip ve yetkiler yazımızda.
Sık sorulanlar
API anahtarını kimler oluşturabilir?
API anahtarı bölümünü yetkisi olan kişiler görür; anahtar oluşturma ve iptal etme de rol izinlerine bağlıdır. Mağaza sahibi ve yöneticiler her zaman erişir.
Anahtarı kaybettim, ne yapmalıyım?
Anahtar güvenlik için bir kez gösterilir. Yeni bir anahtar oluşturup programına yapıştır, eskisini İptal et ile kapat.
Alan adım Cloudflare’de değilse bu uygulamayı kullanabilir miyim?
Cloudflare uygulaması, alan adı Cloudflare’de yönetilen mağazalar içindir. Alan adın başka bir firmadaysa mağazan MultiKolay’ın kendi altyapısıyla hızlı ve güvenli çalışır; ek bir şey yapman gerekmez.
API anahtarı ve webhook’ları panelden kendin açarsın; geliştiricin için belgeler docs.multikolay.com’da.
