API Integrator
API Integrator Kavramı
Görsel görev akışı oluşturma
Drag-and-drop arayüz ile entegrasyon senaryoları oluşturma.
15+ farklı konnektör desteği
Veritabanı, mesaj kuyruğu, HTTP, dosya ve daha fazlası.
Görevler tanımlandıkları sırayla çalışır
Her görev bir önceki görevin çıktısını kullanabilir.
Zamanlayıcı veya HTTP ile tetikleme
Görev akışları zamanlayıcı veya HTTP istekleri ile otomatik çalışabilir.
Hata durumunda ön tanımlı işlemler
Hata durumunda gerçekleşecek işlemler tanımlanabilir.
Adım adım log kayıtları ve istatistikler
Her görevin çalışma ve log kayıtları görüntülenebilir.
Form tabanlı konfigürasyon
Görsel arayüzle kod yazmadan entegrasyon senaryoları oluşturma.
Task Flow'ları API olarak yayınlama
Task Flow'lar REST API veya SOAP web servis olarak yayınlanabilir.
API Integrator Özellikleri
Task Flow Builder
Visual Designer
- Drag-and-drop arayüz
- Konnektör bağlantıları
- Akış kontrolü (IF-THEN-ELSE)
- Loop ve iteration
Data Transformation
- JSON ↔ XML dönüştürme
- Data mapping
- Field transformation
- Data enrichment
Error Handling
- Try-catch blokları
- Error handling stratejileri
- Retry mekanizması
- Fallback stratejileri
Konnektörler
API Integrator, 15+ farklı konnektör desteği sağlar. Konnektörler konnektor.mdx sayfasında detaylı olarak açıklanmıştır:
Database Connector
SQL veritabanlarına bağlantı (MySQL, PostgreSQL, Oracle, MSSQL, DB2). SQL sorguları çalıştırma ve stored procedure çağırma.
Kafka, RabbitMQ, ActiveMQ
Mesaj kuyruğuna mesaj gönderme işlemleri. Event-driven mimariler için mesaj yayınlama.
HTTP/REST, Webhook, Email
REST API çağrıları, webhook gönderme ve e-posta gönderme işlemleri.
FTP/SFTP, Elasticsearch, Script
Dosya transferi, Elasticsearch sorguları ve JavaScript/Groovy script çalıştırma.
Notification, SNMP, Syslog, Logback
Bildirim gönderme, SNMP trap gönderme ve log kayıtları gönderme.
Linux Script
SSH üzerinden uzak Linux sunucularında komut ve betik çalıştırma.
Konnektörler hakkında detaylı bilgi için Konnektör sayfasına bakabilirsiniz.
API Olarak Sunma
REST API
- REST endpoint olarak yayınlama
- HTTP method desteği
- Request/Response handling
Scheduled Execution
- Zamanlanmış çalıştırma
- Cron expression
- Event-based triggering
Task Flow Manager Kullanım Alanları
Farklı sistemler arasında veri aktarımı ve veri alışverişi
Sistemler arası veri senkronizasyonu ve aktarımı.
Otomatik e-posta ve bildirim gönderme
Zamanlanmış veya event-driven bildirimler.
Düzenli ve yönetilebilir raporlama
İş akışları için otomatik rapor oluşturma.
Birden fazla API çağrısını zamanlama
Belirli zaman aralıklarında veya durumlarda API çağrıları.
Kafka, RabbitMQ gibi sistemlere mesaj gönderme
Mesaj kuyruğu sistemlerine veri gönderme.
Task Flow Manager Görev Tipleri
Eğer akış başarısız tamamlanırsa, aşağıdaki görev tiplerinin herhangi birinden eylem (action) tanımlanarak haberdar olunabilir:
Action Görev Tipleri
Task Flow başarısız tamamlandığında çalıştırılabilecek action'lar:
- E-posta Gönderme: E-posta konnektörü ile bildirim gönderme
- API Çağrısı: API Call yaparak harici sistemlere bildirim
- Veritabanı İşlemi: Veritabanı konnektörü ile işlem yapma
- Linux Script: Linux script çalıştırma
- Script: JavaScript/Groovy script çalıştırma
- Bildirim: Bildirim oluşturma
- SNMP: SNMP trap gönderme
Action'lar, Task Flow'un başarısız tamamlanması durumunda otomatik olarak çalıştırılır ve hata durumlarından haberdar olunmasını sağlar.
E-posta konnektörü ile bildirim gönderme
API Call yaparak harici sistemlere bildirim
Veritabanı konnektörü ile işlem yapma
Linux script çalıştırma
JavaScript/Groovy script çalıştırma
Bildirim oluşturma
SNMP trap gönderme
API Integrator Kullanım Senaryoları
- Kaynak sistemden veri çekme (Database Connector)
- Veri dönüştürme (Transformation)
- Hedef sisteme veri gönderme (HTTP Connector)
- Hata durumunda bildirim (Email Connector)
- İşlem sonuçlarını mesaj kuyruğuna gönderme (Kafka/RabbitMQ/ActiveMQ Connector)
- Event yayınlama
- Event-driven mimariler için mesaj gönderme
- FTP'den dosya alma (FTP Connector)
- Dosya içeriğini parse etme (Script Connector)
- Veritabanına kaydetme (Database Connector)
- İşlem sonrası bildirim (Email Connector)
- Alarm ve monitoring durumlarında e-posta gönderme (Email Connector)
- Log kaydetme (Logback/Syslog Connector)
- Bildirim gönderme (Notification Connector)
- API trafik loglarını Elasticsearch, Graylog gibi sistemlere gönderme
- Elasticsearch/Graylog Connector kullanımı
- Merkezi loglama ve analiz
- HTTP to MQTT gibi protokol dönüşümü sağlama
- HTTP protokolü ile mesaj kuyruğuna veri bırakma
- Connector API Proxy oluşturma
API Integrator Avantajları
- Kod yazmadan hızlı entegrasyon
- Visual designer
- Görsel akış diyagramları
- Kolay debug
- Task Flow'ları yeniden kullanma
- Konnektörleri paylaşma
- Yatay ölçeklendirme
- Yüksek throughput
API Integrator Konfigürasyonu ve Erişim
Konfigürasyon Adımları
API Entegratörünü kullanabilmek için konfigürasyon yapılması gerekir:
- Administration sekmesine gidin
- General Settings sayfasını açın
- Define Your API Integration Module alanını bulun
- Entegratörün erişim adresi bilgilerini girin
- Ayarları kaydedin
Entegratör erişim adresi, API Integrator servisinin çalıştığı URL'dir. Bu adres, API Manager'ın API Integrator ile iletişim kurması için gereklidir.
Erişim
Task Flow Manager'a erişim:
Ekranda solda bulunan navigasyon çubuğunda Development sekmesi altında API Integrator (Task Flow Manager) erişebilirsiniz.
API Integrator, Development menüsü altında yer alır ve Task Flow Manager olarak da adlandırılır.