TotalApp Dökümanlar
Ctrl K
EN | TR
Uygulamaya Git

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.

Ekran önizlemesi

Ekrana kısa bir bakış. Koyu ve açık tema arasında geçmek için köşedeki anahtarı kullanın.

app.totalapp.app/enterprise/departments
Tüm Departmanlar + Departman Ekle
Departman Kullanılan Koltuk Yöneticiler Durum
Satış & Gelir
412
14 Aktif Görüntüle
Finans & Muhasebe
286
11 Aktif Görüntüle
İnsan Kaynakları
97
9 İnceleme Vadesi Görüntüle
Mühendislik & BT
164
12 Aktif Görüntüle
Hukuk & Uyumluluk
22
0 Askıya Alındı Görüntüle

Koltuk ve durumlarıyla tüm departmanlar

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/createYeni sipariş oluşturulduğundaStok güncelleme, fatura oluşturma
orders/updatedSipariş durumu değiştiğindeMüşteri bildirimi, kargo takibi
products/updateÜrün bilgisi güncellendiğindeFiyat senkronizasyonu
customers/createYeni müşteri kaydedildiğindeCRM'e otomatik ekleme
refunds/createİade işlemi başlatıldığındaMuhasebe 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

  1. Ayarlar → Entegrasyonlar → İlgili platform sayfasına gidin.
  2. İlgili platformun yönetim panelinde yeni bir API anahtarı veya erişim tokeni oluşturun.
  3. Anahtarı TotalApp'ın ilgili alanına yapıştırın ve kaydedin.
  4. "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.