> ## 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 Integrator), the component in the Apinizer platform that meets integration requirements without writing code and automates them, exposing them as APIs or web services. It is also called Task Flow Manager and is a workflow management system that can automatically execute multiple tasks in a specific order. It performs integration operations between different systems using Task Flows (Task Flows). Integration scenarios can be created with a visual interface and provides support for 15+ different connectors.

## API Integrator Concept

<CardGroup cols={2}>
  <Card title="Task Flow Builder" icon="diagram-project">
    Visual task flow creation

    Creating integration scenarios with drag-and-drop interface.
  </Card>

  <Card title="Connectors" icon="plug">
    Support for 15+ different connectors

    Database, message queue, HTTP, file, and more.
  </Card>

  <Card title="Sequential Tasks" icon="list-ol">
    Tasks run in the order they are defined

    Each task can use the output of the previous task.
  </Card>

  <Card title="Automatic Triggering" icon="clock">
    Triggering with scheduler or HTTP

    Task flows can run automatically with scheduler or HTTP requests.
  </Card>

  <Card title="Error Management" icon="triangle-exclamation">
    Predefined operations in case of error

    Operations to be performed in case of error can be defined.
  </Card>

  <Card title="Monitoring and Logging" icon="chart-bar">
    Step-by-step log records and statistics

    Execution and log records of each task can be viewed.
  </Card>

  <Card title="No Code Writing" icon="wand-magic-sparkles">
    Form-based configuration

    Creating integration scenarios without writing code with visual interface.
  </Card>

  <Card title="Expose as API" icon="code">
    Publishing Task Flows as APIs

    Task Flows can be published as REST API or SOAP web service.
  </Card>
</CardGroup>

## API Integrator Features

### Task Flow Builder

<AccordionGroup>
  <Accordion title="Visual Designer">
    * Drag-and-drop interface
    * Connector connections
    * Flow control (IF-THEN-ELSE)
    * Loop and iteration
  </Accordion>

  <Accordion title="Data Transformation">
    * JSON ↔ XML conversion
    * Data mapping
    * Field transformation
    * Data enrichment
  </Accordion>

  <Accordion title="Error Handling">
    * Try-catch blocks
    * Error handling strategies
    * Retry mechanism
    * Fallback strategies
  </Accordion>
</AccordionGroup>

### Connectors

API Integrator provides support for 15+ different connectors. Connectors are explained in detail on the connector.mdx page:

<CardGroup cols={2}>
  <Card title="Database Connectors" icon="database">
    Database Connector

    Connection to SQL databases (MySQL, PostgreSQL, Oracle, MSSQL, DB2). Running SQL queries and calling stored procedures.
  </Card>

  <Card title="Message Queue Connectors" icon="inbox">
    Kafka, RabbitMQ, ActiveMQ

    Sending messages to message queues. Message publishing for event-driven architectures.
  </Card>

  <Card title="Communication Connectors" icon="globe">
    HTTP/REST, Webhook, Email

    REST API calls, sending webhooks, and email sending operations.
  </Card>

  <Card title="File and Data Connectors" icon="file">
    FTP/SFTP, Elasticsearch, Script

    File transfer, Elasticsearch queries, and running JavaScript/Groovy scripts.
  </Card>

  <Card title="Monitoring and Notification Connectors" icon="bell">
    Notification, SNMP, Syslog, Logback

    Sending notifications, sending SNMP traps, and sending log records.
  </Card>

  <Card title="System Connectors" icon="terminal">
    Linux Script

    Running commands and scripts on remote Linux servers via SSH.
  </Card>
</CardGroup>

<Tip>
  For detailed information about connectors, see the [Connector](/en/concepts/core-concepts/connector) page.
</Tip>

### Expose as API

<AccordionGroup>
  <Accordion title="REST API">
    * Publishing as REST endpoint
    * HTTP method support
    * Request/Response handling
  </Accordion>

  <Accordion title="Scheduled Execution">
    * Scheduled execution
    * Cron expression
    * Event-based triggering
  </Accordion>
</AccordionGroup>

## Task Flow Manager Usage Areas

<CardGroup cols={2}>
  <Card title="Data Transfer" icon="arrows-rotate">
    Data transfer and exchange between different systems

    Data synchronization and transfer between systems.
  </Card>

  <Card title="Automatic Notifications" icon="envelope">
    Automatic email and notification sending

    Scheduled or event-driven notifications.
  </Card>

  <Card title="Reporting" icon="file-pdf">
    Regular and manageable reporting

    Automatic report generation for business workflows.
  </Card>

  <Card title="API Calls" icon="plug">
    Scheduling multiple API calls

    API calls at specific time intervals or conditions.
  </Card>

  <Card title="Message Queue" icon="inbox">
    Sending messages to systems like Kafka, RabbitMQ

    Sending data to message queue systems.
  </Card>
</CardGroup>

## Task Flow Manager Task Types

If the flow fails to complete successfully, you can be notified by defining an **action** from any of the following task types:

<AccordionGroup>
  <Accordion title="Action Task Types">
    Actions that can be executed when Task Flow fails to complete successfully:

    * **Send Email**: Sending notifications with email connector
    * **API Call**: Notifying external systems by making API Call
    * **Database Operation**: Performing operations with database connector
    * **Linux Script**: Running Linux script
    * **Script**: Running JavaScript/Groovy script
    * **Notification**: Creating notification
    * **SNMP**: Sending SNMP trap

    <Tip>
      Actions are automatically executed when Task Flow fails to complete successfully and ensure awareness of error situations.
    </Tip>
  </Accordion>
</AccordionGroup>

<CardGroup cols={2}>
  <Card title="Send Email" icon="envelope">
    Sending notifications with email connector
  </Card>

  <Card title="API Call" icon="plug">
    Notifying external systems by making API Call
  </Card>

  <Card title="Database Operation" icon="database">
    Performing operations with database connector
  </Card>

  <Card title="Linux Script" icon="terminal">
    Running Linux script
  </Card>

  <Card title="Script" icon="code">
    Running JavaScript/Groovy script
  </Card>

  <Card title="Notification" icon="bell">
    Creating notification
  </Card>

  <Card title="SNMP" icon="network-wired">
    Sending SNMP trap
  </Card>
</CardGroup>

## API Integrator Usage Scenarios

<CardGroup cols={3}>
  <Card title="Data Synchronization" icon="arrows-rotate">
    1. Pulling data from source system (Database Connector)
    2. Data transformation (Transformation)
    3. Sending data to target system (HTTP Connector)
    4. Notification in case of error (Email Connector)
  </Card>

  <Card title="Sending Messages to Message Queue" icon="bolt">
    1. Sending operation results to message queue (Kafka/RabbitMQ/ActiveMQ Connector)
    2. Event publishing
    3. Sending messages for event-driven architectures
  </Card>

  <Card title="File Processing" icon="file">
    1. Getting file from FTP (FTP Connector)
    2. Parsing file content (Script Connector)
    3. Saving to database (Database Connector)
    4. Notification after operation (Email Connector)
  </Card>

  <Card title="Notification and Logging" icon="bell">
    1. Sending email in alarm and monitoring situations (Email Connector)
    2. Logging (Logback/Syslog Connector)
    3. Sending notifications (Notification Connector)
  </Card>

  <Card title="API Traffic Logging" icon="file-lines">
    1. Sending API traffic logs to systems like Elasticsearch, Graylog
    2. Using Elasticsearch/Graylog Connector
    3. Central logging and analysis
  </Card>

  <Card title="Protocol Conversion" icon="arrows-rotate">
    1. Providing protocol conversion like HTTP to MQTT
    2. Leaving data in message queue with HTTP protocol
    3. Creating Connector API Proxy
  </Card>
</CardGroup>

## API Integrator Advantages

<CardGroup cols={2}>
  <Card title="Rapid Development" icon="bolt">
    * Rapid integration without writing code
    * Visual designer
  </Card>

  <Card title="Easy Maintenance" icon="wrench">
    * Visual flow diagrams
    * Easy debugging
  </Card>

  <Card title="Reusability" icon="recycle">
    * Reusing Task Flows
    * Sharing connectors
  </Card>

  <Card title="Scalability" icon="arrows-up-down">
    * Horizontal scaling
    * High throughput
  </Card>
</CardGroup>

## API Integrator Configuration and Access

<AccordionGroup>
  <Accordion title="Configuration Steps">
    Configuration needs to be done to use API Integrator:

    1. Go to **Administration** tab
    2. Open **General Settings** page
    3. Find **Define Your API Integration Module** field
    4. Enter the integrator access address information
    5. Save settings

    <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 Settings" width="800" height="450" data-path="images/develop/api-integrator/api-integrator-ayarlari.png" />

    <Tip>
      The integrator access address is the URL where the API Integrator service is running. This address is required for API Manager to communicate with API Integrator.
    </Tip>
  </Accordion>

  <Accordion title="Access">
    Accessing Task Flow Manager:

    You can access **API Integrator** (Task Flow Manager) under the **Development** tab in the navigation bar on the left side of the screen.

    <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 Access" width="800" height="450" data-path="images/develop/api-integrator/api-integrator-erisim.png" />

    <Tip>
      API Integrator is located under the Development menu and is also called Task Flow Manager.
    </Tip>
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Connectors" icon="plug" href="/en/concepts/core-concepts/connector">
    Learn about connector concept
  </Card>

  <Card title="Task Flow Builder" icon="diagram-project" href="/en/integrations/api-integrator-task-flow-builder/overview">
    Task Flow Builder usage
  </Card>

  <Card title="Connections" icon="plug" href="/en/concepts/core-concepts/connections">
    Learn about connection concept
  </Card>

  <Card title="API Creator" icon="wand-magic-sparkles" href="/en/concepts/core-components/api-creator">
    Learn about API Creator component
  </Card>
</CardGroup>