Ana içeriğe atla

API Integrator Kavramı

Task Flow Builder

Görsel görev akışı oluşturmaDrag-and-drop arayüz ile entegrasyon senaryoları oluşturma.

Konnektörler

15+ farklı konnektör desteğiVeritabanı, mesaj kuyruğu, HTTP, dosya ve daha fazlası.

Sıralı Görevler

Görevler tanımlandıkları sırayla çalışırHer görev bir önceki görevin çıktısını kullanabilir.

Otomatik Tetikleme

Zamanlayıcı veya HTTP ile tetiklemeGörev akışları zamanlayıcı veya HTTP istekleri ile otomatik çalışabilir.

Hata Yönetimi

Hata durumunda ön tanımlı işlemlerHata durumunda gerçekleşecek işlemler tanımlanabilir.

İzleme ve Loglama

Adım adım log kayıtları ve istatistiklerHer görevin çalışma ve log kayıtları görüntülenebilir.

Kod Yazmadan

Form tabanlı konfigürasyonGörsel arayüzle kod yazmadan entegrasyon senaryoları oluşturma.

API Olarak Sunma

Task Flow’ları API olarak yayınlamaTask Flow’lar REST API veya SOAP web servis olarak yayınlanabilir.

API Integrator Özellikleri

Task Flow Builder

  • Drag-and-drop arayüz
  • Konnektör bağlantıları
  • Akış kontrolü (IF-THEN-ELSE)
  • Loop ve iteration
  • JSON ↔ XML dönüştürme
  • Data mapping
  • Field transformation
  • Data enrichment
  • 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:

Veritabanı Konnektörleri

Database ConnectorSQL veritabanlarına bağlantı (MySQL, PostgreSQL, Oracle, MSSQL, DB2). SQL sorguları çalıştırma ve stored procedure çağırma.

Mesaj Kuyruğu Konnektörleri

Kafka, RabbitMQ, ActiveMQMesaj kuyruğuna mesaj gönderme işlemleri. Event-driven mimariler için mesaj yayınlama.

İletişim Konnektörleri

HTTP/REST, Webhook, EmailREST API çağrıları, webhook gönderme ve e-posta gönderme işlemleri.

Dosya ve Veri Konnektörleri

FTP/SFTP, Elasticsearch, ScriptDosya transferi, Elasticsearch sorguları ve JavaScript/Groovy script çalıştırma.

Monitoring ve Bildirim Konnektörleri

Notification, SNMP, Syslog, LogbackBildirim gönderme, SNMP trap gönderme ve log kayıtları gönderme.

Sistem Konnektörleri

Linux ScriptSSH ü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 endpoint olarak yayınlama
  • HTTP method desteği
  • Request/Response handling
  • Zamanlanmış çalıştırma
  • Cron expression
  • Event-based triggering

Task Flow Manager Kullanım Alanları

Veri Aktarımı

Farklı sistemler arasında veri aktarımı ve veri alışverişiSistemler arası veri senkronizasyonu ve aktarımı.

Otomatik Bildirimler

Otomatik e-posta ve bildirim göndermeZamanlanmış veya event-driven bildirimler.

Raporlama

Düzenli ve yönetilebilir raporlamaİş akışları için otomatik rapor oluşturma.

API Çağrıları

Birden fazla API çağrısını zamanlamaBelirli zaman aralıklarında veya durumlarda API çağrıları.

Mesaj Kuyruğu

Kafka, RabbitMQ gibi sistemlere mesaj göndermeMesaj 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:
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 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

API Integrator Kullanım Senaryoları

Veri Senkronizasyonu

  1. Kaynak sistemden veri çekme (Database Connector)
  2. Veri dönüştürme (Transformation)
  3. Hedef sisteme veri gönderme (HTTP Connector)
  4. Hata durumunda bildirim (Email Connector)

Mesaj Kuyruğuna Mesaj Gönderme

  1. İşlem sonuçlarını mesaj kuyruğuna gönderme (Kafka/RabbitMQ/ActiveMQ Connector)
  2. Event yayınlama
  3. Event-driven mimariler için mesaj gönderme

File Processing

  1. FTP’den dosya alma (FTP Connector)
  2. Dosya içeriğini parse etme (Script Connector)
  3. Veritabanına kaydetme (Database Connector)
  4. İşlem sonrası bildirim (Email Connector)

Bildirim ve Loglama

  1. Alarm ve monitoring durumlarında e-posta gönderme (Email Connector)
  2. Log kaydetme (Logback/Syslog Connector)
  3. Bildirim gönderme (Notification Connector)

API Trafik Loglama

  1. API trafik loglarını Elasticsearch, Graylog gibi sistemlere gönderme
  2. Elasticsearch/Graylog Connector kullanımı
  3. Merkezi loglama ve analiz

Protokol Dönüşümü

  1. HTTP to MQTT gibi protokol dönüşümü sağlama
  2. HTTP protokolü ile mesaj kuyruğuna veri bırakma
  3. Connector API Proxy oluşturma

API Integrator Avantajları

Hızlı Geliştirme

  • Kod yazmadan hızlı entegrasyon
  • Visual designer

Kolay Bakım

  • Görsel akış diyagramları
  • Kolay debug

Yeniden Kullanım

  • Task Flow’ları yeniden kullanma
  • Konnektörleri paylaşma

Ölçeklenebilirlik

  • Yatay ölçeklendirme
  • Yüksek throughput

API Integrator Konfigürasyonu ve Erişim

API Entegratörünü kullanabilmek için konfigürasyon yapılması gerekir:
  1. Administration sekmesine gidin
  2. General Settings sayfasını açın
  3. Define Your API Integration Module alanını bulun
  4. Entegratörün erişim adresi bilgilerini girin
  5. Ayarları kaydedin
API Integrator Ayarları
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.
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 Erişim
API Integrator, Development menüsü altında yer alır ve Task Flow Manager olarak da adlandırılır.

Sonraki Adımlar