01Mimari: kaynak → ara katman → hedef
Kaynak
Mevcut yazılımınız: verinin doğduğu yer.
Ara katman
Değişikliği yakalar, alanları eşleştirir, birimleri dönüştürür, kuyruğa alır ve loglar.
Hedef
API sunan diğer sistemler: verinin gideceği yer.
02Tetikleme yöntemleri
| Yöntem | Ne zaman | Not |
|---|---|---|
| Anlık (webhook) | Karşı sistem olay bildirimi sunuyorsa | En hızlı; imza doğrulaması gerekir |
| Zamanlanmış | Toplu güncellemelerde | Oran sınırına uygun dağıtılır |
| Değişiklik takibi | Kaynakta değişiklik zamanı tutuluyorsa | Yalnız değişenler gönderilir |
03Bağlantı yöntemleri
API
Sistemin resmî programlama arayüzü üzerinden veri alışverişi; en güvenilir ve izlenebilir yöntemdir.
Webhook
Bir olay olduğunda karşı sistemin anında haberdar edilmesi; sürekli sorgulama ihtiyacını azaltır.
Dosya aktarımı
CSV veya XML dosyalarının zamanlanmış olarak alınıp verilmesi; API olmayan sistemlerde kullanılır.
04Ergani için çalışma düzeni
Ergani'nin PTT verisindeki 107 yerleşim kaydı 1 farklı posta koduna dağılır. Diyarbakır gibi büyükşehirlerde satış birden fazla kanaldan ve şubeden yürüyebilir; API entegrasyonu için verinin tek kaynaktan dağıtılması tutarlılığı korur.
Mesafe yazılım işinin önünde engel değildir: Ergani'deki ekiplerle görüntülü görüşme, ekran paylaşımı ve test ortamı bağlantısıyla çalışılır; cihaz kurulumu veya saha keşfi gerekirse yerinde ziyaret planlanır.
Aynı ildeki Sur, Kulp ve Hani ilçeleri için de API entegrasyonu talepleri değerlendirilir; toplantılar uzaktan yapılır.
Ergani bölgesinden API entegrasyonu için mevcut programınızı ve satış kanallarınızı paylaşmanız ön değerlendirme için yeterli. 0540 003 19 81 numarasını arayabilirsiniz.
05API entegrasyonu hangi işletmelerde kullanılır?
- Çok şubeli işletmeler
- E-ticaret ve B2B satıcıları
- Yazılım ekosistemi dağınık firmalar
- Kurumsal satış ekipleri
06Kapsamı ve maliyeti etkileyenler
- izleme/bakım
- çift yön/gerçek zamanlı ihtiyacı
- veri türü ve hacmi
- sistem sayısı
07Planlama notları
- Kimlik ve yetki bilgileri güvenli saklanır; erişim en az yetkiyle verilir.
- Bağlantı yöntemi, sistemin sunduğu imkâna göre seçilir: REST/SOAP API, webhook, dosya (CSV/XML), veritabanı görünümü.
- Hata durumunda yeniden deneme, kuyruk ve bildirim kurgulanır.
08Kuyruk ve yeniden deneme
Her kayıt kuyruğa alınır; karşı sistem yanıt vermezse belirli aralıklarla yeniden denenir. Belirli sayıdan sonra başarısız kayıt hata listesine düşer ve bildirim gider.
| Veri | Yön | Sıklık |
|---|---|---|
| Ana kayıtlar (eşleştirilen alanlar) | kaynak → hedef | değişiklikte veya zamanlanmış |
SSSSık sorulan sorular
Ara katman nerede çalışır?
Bulut sunucuda veya şirket içi bir sunucuda çalışabilir; seçim veri güvenliği ve erişim ihtiyacına göre yapılır.
Anlık mı zamanlanmış mı olmalı?
Stok ve sipariş gibi hızlı değişen verilerde anlık veya kısa aralıklı akış; ürün açıklaması gibi seyrek değişen verilerde zamanlanmış akış yeterlidir.
API entegrasyonu için hangi erişimler gerekir?
Bağlanacak sistemlerin resmî API veya entegrasyon bilgileri, varsa test hesabı ve verinin ana kaynağının hangi sistem olacağı kararı gerekir.
Ergani'de bulunuyorum, yerinde görüşme mümkün mü?
Analiz, tasarım ve geliştirme çoğunlukla uzaktan, görüntülü toplantılarla yürür; donanım kurulumu, saha keşfi veya kullanıcı eğitimi gereken işlerde yerinde çalışma planlanır.
API entegrasyonu çalışırken bir kayıt aktarılamazsa ne olur?
Başarısız aktarım hata kuyruğunda bekletilir, yeniden denenir ve raporlanır; hangi kaydın neden aktarılamadığı görülür.
Sadece Diyarbakır için mi çalışıyorsunuz?
Evet. Askadar Yazılım, Türkiye'nin 81 ilindeki işletmelerle uzaktan çalışır; gerektiğinde yerinde çalışma ayrıca planlanır.
Veri anlık mı aktarılır?
Karşı sistem olay bildirimi sunuyorsa anlık; sunmuyorsa kısa aralıklı zamanlanmış görevlerle aktarılır.
Logo veya Mikro entegrasyonu için lisans gerekir mi?
Entegrasyon ürünün resmî araçları ve lisans koşullarıyla yapılır; bazı bağlantı yöntemleri ek modül veya kullanıcı lisansı gerektirebilir. Bunu analizde ürün sağlayıcınızın güncel koşullarıyla birlikte netleştiririz.
→İlgili sayfalar
API Entegrasyonu hakkında diğer konular
- API entegrasyonu test ve canlıya almaTest ortamı ve geçiş
- API entegrasyonu çoklu platform yönetimiBirden çok sistemle birlikte kullanım
- API entegrasyonunun güvenliğiKimlik bilgisi, yetki ve veri güvenliği
- API entegrasyonu hataları ve çözümleriSık hatalar ve nedenleri
- API entegrasyonuKapsam, akış ve kurulum
Ergani'de ilgili hizmetler
Diyarbakır içindeki diğer ilçeler
Bu sayfada geçen kavramlar
- eşleştirme
- zamanlama
- hata yönetimi
- CSV
- REST
- XML
- webhook
- senkronizasyon
- SOAP
- Diyarbakır
- Ergani