API & Entegrasyon

TotalApp'ı dış sistemlere bağlayın — Shopify, WooCommerce, webhooks ve REST API ile tam entegrasyon.

Hızlı Başlangıç

TotalApp'ın entegrasyon özelliklerini kullanmaya başlamak için aşağıdaki adımları izleyin.

1. Ayarlar'a gidin

→

2. Entegrasyonlar sekmesini açın

→

3. Platform seçin

→

4. API anahtarı girin

→

5. Bağlantıyı test edin

İpucu

Entegrasyon bağlantısını test etmek için "Bağlantıyı Doğrula" düğmesini kullanın. Başarılı bağlantı yeşil onay simgesiyle gösterilir.

Desteklenen Entegrasyonlar

TotalApp, en yaygın kullanılan e-ticaret ve iş platformlarıyla doğrudan entegre olur.

Shopify

Ürünler, siparişler ve müşteri verilerini Shopify mağazanızdan gerçek zamanlı çekebilirsiniz. Stok senkronizasyonu ve sipariş yönetimi tam otomatik çalışır.

WooCommerce

WordPress/WooCommerce mağazanızı bağlayarak satış verilerinizi, ürün katalog bilgilerini ve müşteri listelerinizi TotalApp'a aktarın.

Webhooks

Dış sistemlerden gelen olayları gerçek zamanlı olarak alın. Sipariş oluşturulduğunda, ürün güncellendiğinde veya müşteri kaydedildiğinde otomatik akışlar tetikleyin.

REST API

TotalApp'ın REST API'sini kullanarak kendi uygulamalarınızı veya sistemlerinizi entegre edin. JSON tabanlı standart HTTP endpoint'leri mevcuttur.

Webhook Yapısı

Webhooks, dış bir sistemde bir olay gerçekleştiğinde TotalApp'a anlık bildirim gönderen HTTP POST istekleridir. Entegrasyon panelinden webhook URL'nizi kopyalayarak dış platformunuza yapıştırın.

Desteklenen Olay Tipleri

Olay	Tetikleyici	Örnek Kullanım
orders/create	Yeni sipariş oluşturulduğunda	Stok güncelleme, fatura oluşturma
orders/updated	Sipariş durumu değiştiğinde	Müşteri bildirimi, kargo takibi
products/update	Ürün bilgisi güncellendiğinde	Fiyat senkronizasyonu
customers/create	Yeni müşteri kaydedildiğinde	CRM'e otomatik ekleme
refunds/create	İade işlemi başlatıldığında	Muhasebe kaydı, stok iadesi

Güvenlik Notu

Webhook uç noktanız HTTPS üzerinden çalışmalıdır. TotalApp, gelen webhook isteklerini imzalı başlıklarla doğrular; sahte istekler otomatik olarak reddedilir.

API Anahtarı Yönetimi

TotalApp entegrasyonları, her platform için ayrı API anahtarları kullanır. Anahtarlarınızı güvenli bir şekilde saklamak ve yönetmek için aşağıdaki adımları izleyin.

API Anahtarı Oluşturma

Ayarlar → Entegrasyonlar → İlgili platform sayfasına gidin.
İlgili platformun yönetim panelinde yeni bir API anahtarı veya erişim tokeni oluşturun.
Anahtarı TotalApp'ın ilgili alanına yapıştırın ve kaydedin.
"Bağlantıyı Doğrula" düğmesine tıklayarak anahtarın doğru çalıştığını teyit edin.

Güvenlik Kuralları

API anahtarlarını asla üçüncü taraflarla paylaşmayın.
Yalnızca gerekli izinlere sahip API anahtarları oluşturun (salt okunur veya sipariş yönetimi için sınırlı erişim).
Kullanılmayan entegrasyonları silin veya devre dışı bırakın.
Anahtarınızın ele geçirildiğini düşünüyorsanız hemen yenileyin.

Dikkat

Shopify API anahtarlarının "read_orders", "read_products" ve "read_customers" izinlerine sahip olması gerekir. Eksik izinler veri çekme hatalarına yol açar.

Sık Sorulan Sorular

Hangi Shopify planlarıyla entegrasyon çalışır?

TotalApp'ın Shopify entegrasyonu, Basic ve üzeri tüm Shopify planlarıyla uyumludur. Shopify Starter planı API erişimine izin vermediğinden entegrasyon bu planda desteklenmez.

Webhook olayları gerçek zamanlı mı iletiliyor?

Evet, webhook olayları anlık olarak TotalApp'a iletilir. Sunucu tarafında SSE (Server-Sent Events) mimarisi kullanıldığından, tarayıcı sekmesi açık olduğu sürece veriler saniyeler içinde ekrana yansır.

WooCommerce ile Shopify'ı aynı anda kullanabilir miyim?

Evet, TotalApp aynı anda birden fazla entegrasyonu destekler. Her platformun verileri ayrı bölümlerde görüntülenir ve entegrasyon logları birbirinden bağımsız tutulur.