> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apinizer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API Integrator

> API Integrator (API Entegratörü), Apinizer platformunda entegrasyon gereksinimlerini kod yazmadan ve otomatikleştirerek karşılayan ve bunları API veya web servis olarak sunan bileşendir. Task Flow Manager olarak da adlandırılır ve birden fazla görevi belirli bir sıraya göre otomatik olarak işletebilen bir iş akış yönetim sistemidir. Farklı sistemler arasında entegrasyon işlemlerini Task Flow'lar (Görev Akışları) kullanarak gerçekleştirir. Görsel bir arayüzle entegrasyon senaryoları oluşturulabilir ve 15+ farklı konnektör desteği sağlar.

## API Integrator Kavramı

<CardGroup cols={2}>
  <Card title="Task Flow Builder" icon="diagram-project">
    Görsel görev akışı oluşturma

    Drag-and-drop arayüz ile entegrasyon senaryoları oluşturma.
  </Card>

  <Card title="Konnektörler" icon="plug">
    15+ farklı konnektör desteği

    Veritabanı, mesaj kuyruğu, HTTP, dosya ve daha fazlası.
  </Card>

  <Card title="Sıralı Görevler" icon="list-ol">
    Görevler tanımlandıkları sırayla çalışır

    Her görev bir önceki görevin çıktısını kullanabilir.
  </Card>

  <Card title="Otomatik Tetikleme" icon="clock">
    Zamanlayıcı veya HTTP ile tetikleme

    Görev akışları zamanlayıcı veya HTTP istekleri ile otomatik çalışabilir.
  </Card>

  <Card title="Hata Yönetimi" icon="triangle-exclamation">
    Hata durumunda ön tanımlı işlemler

    Hata durumunda gerçekleşecek işlemler tanımlanabilir.
  </Card>

  <Card title="İzleme ve Loglama" icon="chart-bar">
    Adım adım log kayıtları ve istatistikler

    Her görevin çalışma ve log kayıtları görüntülenebilir.
  </Card>

  <Card title="Kod Yazmadan" icon="wand-magic-sparkles">
    Form tabanlı konfigürasyon

    Görsel arayüzle kod yazmadan entegrasyon senaryoları oluşturma.
  </Card>

  <Card title="API Olarak Sunma" icon="code">
    Task Flow'ları API olarak yayınlama

    Task Flow'lar REST API veya SOAP web servis olarak yayınlanabilir.
  </Card>
</CardGroup>

## API Integrator Özellikleri

### Task Flow Builder

<AccordionGroup>
  <Accordion title="Visual Designer">
    * Drag-and-drop arayüz
    * Konnektör bağlantıları
    * Akış kontrolü (IF-THEN-ELSE)
    * Loop ve iteration
  </Accordion>

  <Accordion title="Data Transformation">
    * JSON ↔ XML dönüştürme
    * Data mapping
    * Field transformation
    * Data enrichment
  </Accordion>

  <Accordion title="Error Handling">
    * Try-catch blokları
    * Error handling stratejileri
    * Retry mekanizması
    * Fallback stratejileri
  </Accordion>
</AccordionGroup>

### Konnektörler

API Integrator, 15+ farklı konnektör desteği sağlar. Konnektörler konnektor.mdx sayfasında detaylı olarak açıklanmıştır:

<CardGroup cols={2}>
  <Card title="Veritabanı Konnektörleri" icon="database">
    Database Connector

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

  <Card title="Mesaj Kuyruğu Konnektörleri" icon="inbox">
    Kafka, RabbitMQ, ActiveMQ

    Mesaj kuyruğuna mesaj gönderme işlemleri. Event-driven mimariler için mesaj yayınlama.
  </Card>

  <Card title="İletişim Konnektörleri" icon="globe">
    HTTP/REST, Webhook, Email

    REST API çağrıları, webhook gönderme ve e-posta gönderme işlemleri.
  </Card>

  <Card title="Dosya ve Veri Konnektörleri" icon="file">
    FTP/SFTP, Elasticsearch, Script

    Dosya transferi, Elasticsearch sorguları ve JavaScript/Groovy script çalıştırma.
  </Card>

  <Card title="Monitoring ve Bildirim Konnektörleri" icon="bell">
    Notification, SNMP, Syslog, Logback

    Bildirim gönderme, SNMP trap gönderme ve log kayıtları gönderme.
  </Card>

  <Card title="Sistem Konnektörleri" icon="terminal">
    Linux Script

    SSH üzerinden uzak Linux sunucularında komut ve betik çalıştırma.
  </Card>
</CardGroup>

<Tip>
  Konnektörler hakkında detaylı bilgi için [Konnektör](/tr/concepts/temel-kavramlar/konnektor) sayfasına bakabilirsiniz.
</Tip>

### API Olarak Sunma

<AccordionGroup>
  <Accordion title="REST API">
    * REST endpoint olarak yayınlama
    * HTTP method desteği
    * Request/Response handling
  </Accordion>

  <Accordion title="Scheduled Execution">
    * Zamanlanmış çalıştırma
    * Cron expression
    * Event-based triggering
  </Accordion>
</AccordionGroup>

## Task Flow Manager Kullanım Alanları

<CardGroup cols={2}>
  <Card title="Veri Aktarımı" icon="arrows-rotate">
    Farklı sistemler arasında veri aktarımı ve veri alışverişi

    Sistemler arası veri senkronizasyonu ve aktarımı.
  </Card>

  <Card title="Otomatik Bildirimler" icon="envelope">
    Otomatik e-posta ve bildirim gönderme

    Zamanlanmış veya event-driven bildirimler.
  </Card>

  <Card title="Raporlama" icon="file-pdf">
    Düzenli ve yönetilebilir raporlama

    İş akışları için otomatik rapor oluşturma.
  </Card>

  <Card title="API Çağrıları" icon="plug">
    Birden fazla API çağrısını zamanlama

    Belirli zaman aralıklarında veya durumlarda API çağrıları.
  </Card>

  <Card title="Mesaj Kuyruğu" icon="inbox">
    Kafka, RabbitMQ gibi sistemlere mesaj gönderme

    Mesaj kuyruğu sistemlerine veri gönderme.
  </Card>
</CardGroup>

## 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:

<AccordionGroup>
  <Accordion title="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

    <Tip>
      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.
    </Tip>
  </Accordion>
</AccordionGroup>

<CardGroup cols={2}>
  <Card title="E-posta Gönderme" icon="envelope">
    E-posta konnektörü ile bildirim gönderme
  </Card>

  <Card title="API Çağrısı" icon="plug">
    API Call yaparak harici sistemlere bildirim
  </Card>

  <Card title="Veritabanı İşlemi" icon="database">
    Veritabanı konnektörü ile işlem yapma
  </Card>

  <Card title="Linux Script" icon="terminal">
    Linux script çalıştırma
  </Card>

  <Card title="Script" icon="code">
    JavaScript/Groovy script çalıştırma
  </Card>

  <Card title="Bildirim" icon="bell">
    Bildirim oluşturma
  </Card>

  <Card title="SNMP" icon="network-wired">
    SNMP trap gönderme
  </Card>
</CardGroup>

## API Integrator Kullanım Senaryoları

<CardGroup cols={3}>
  <Card title="Veri Senkronizasyonu" icon="arrows-rotate">
    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)
  </Card>

  <Card title="Mesaj Kuyruğuna Mesaj Gönderme" icon="bolt">
    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
  </Card>

  <Card title="File Processing" icon="file">
    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)
  </Card>

  <Card title="Bildirim ve Loglama" icon="bell">
    1. Alarm ve monitoring durumlarında e-posta gönderme (Email Connector)
    2. Log kaydetme (Logback/Syslog Connector)
    3. Bildirim gönderme (Notification Connector)
  </Card>

  <Card title="API Trafik Loglama" icon="file-lines">
    1. API trafik loglarını Elasticsearch, Graylog gibi sistemlere gönderme
    2. Elasticsearch/Graylog Connector kullanımı
    3. Merkezi loglama ve analiz
  </Card>

  <Card title="Protokol Dönüşümü" icon="arrows-rotate">
    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
  </Card>
</CardGroup>

## API Integrator Avantajları

<CardGroup cols={2}>
  <Card title="Hızlı Geliştirme" icon="bolt">
    * Kod yazmadan hızlı entegrasyon
    * Visual designer
  </Card>

  <Card title="Kolay Bakım" icon="wrench">
    * Görsel akış diyagramları
    * Kolay debug
  </Card>

  <Card title="Yeniden Kullanım" icon="recycle">
    * Task Flow'ları yeniden kullanma
    * Konnektörleri paylaşma
  </Card>

  <Card title="Ölçeklenebilirlik" icon="arrows-up-down">
    * Yatay ölçeklendirme
    * Yüksek throughput
  </Card>
</CardGroup>

## API Integrator Konfigürasyonu ve Erişim

<AccordionGroup>
  <Accordion title="Konfigürasyon Adımları">
    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

    <img src="https://mintcdn.com/apinizer/PjHeFMTcHBq5-E_G/images/develop/api-integrator/api-integrator-ayarlari.png?fit=max&auto=format&n=PjHeFMTcHBq5-E_G&q=85&s=47feae99609a0301528557b0ab898261" alt="API Integrator Ayarları" width="800" height="450" data-path="images/develop/api-integrator/api-integrator-ayarlari.png" />

    <Tip>
      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.
    </Tip>
  </Accordion>

  <Accordion title="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.

    <img src="https://mintcdn.com/apinizer/PjHeFMTcHBq5-E_G/images/develop/api-integrator/api-integrator-erisim.png?fit=max&auto=format&n=PjHeFMTcHBq5-E_G&q=85&s=699c47ac6303cffa601a323af1d8d19a" alt="API Integrator Erişim" width="800" height="450" data-path="images/develop/api-integrator/api-integrator-erisim.png" />

    <Tip>
      API Integrator, Development menüsü altında yer alır ve Task Flow Manager olarak da adlandırılır.
    </Tip>
  </Accordion>
</AccordionGroup>

## Sonraki Adımlar

<CardGroup cols={2}>
  <Card title="Konnektörler" icon="plug" href="/tr/concepts/temel-kavramlar/konnektor">
    Konnektör kavramını öğrenin
  </Card>

  <Card title="Task Flow Builder" icon="diagram-project" href="/tr/integrations/api-integrator-task-flow-builder/genel-bakis">
    Task Flow Builder kullanımı
  </Card>

  <Card title="Bağlantılar" icon="plug" href="/tr/concepts/temel-kavramlar/baglantilar">
    Bağlantı kavramını öğrenin
  </Card>

  <Card title="API Creator" icon="wand-magic-sparkles" href="/tr/concepts/temel-bilesenler/api-creator">
    API Creator bileşenini öğrenin
  </Card>
</CardGroup>