Richiesta API

Richiesta API

Il componente Richiesta API ti permette di collegare i tuoi flussi a API esterne inviando richieste HTTP personalizzabili e gestendo le risposte.

API Integration Webhooks Automation
Provalo Ora Prenota una demo

Descrizione del componente

Come funziona il componente Richiesta API

The API Request component is a versatile tool designed to facilitate HTTP requests within your AI workflows. It enables your workflow to interact with external APIs or web services by sending requests to one or more URLs and processing the responses. This capability is essential for tasks such as data retrieval, integration with third-party services, or invoking custom endpoints as part of automated or intelligent processes.

What Does the Component Do?

This component allows you to configure and send HTTP requests (GET, POST, PATCH, PUT) to specified URLs. You can customize the request by adding headers, query parameters, and a request body. It also supports handling form data and setting custom timeouts, making it suitable for a wide range of API interactions.

Inputs

The API Request component supports the following configurable inputs:

FieldDescriptionTypeDefault/Options
URLEnter one or more target URLs, separated by commas.String
MethodHTTP method to use for the request.DropdownGET, POST, PATCH, PUT
HeadersCustom headers to include in the request (as a dictionary).Dictionary/Data
BodyData payload for POST, PATCH, or PUT requests (as a dictionary).Dictionary/Data
Query ParametersKey-value pairs to append as URL query parameters.Dictionary/Data
Use Form DataToggle to send data as application/x-www-form-urlencoded.Booleanfalse
TimeoutTime (in seconds) before the request times out.Integer5
Cache TTLHow long to cache the API response. Set to ‘No cache’ to disable.DropdownNo cache, 5 min, … etc.
VerboseIf enabled, prints verbose output for debugging.Booleanfalse
Tool NameName for this API request tool (for use by agents).String
Tool DescriptionDescription to help agents understand how to use this tool.String (multiline)

Outputs

The component produces two main outputs:

Output NameTypeDescription
DataDataThe response data from the API request.
ToolToolMakes this API request available as a “tool” for agent-based workflows.

Why Use This Component?

  • Integration: Connect your AI workflow to any external API or web service, making it easy to augment your processes with new data or actions.
  • Flexibility: Supports multiple HTTP methods, custom headers, bodies, and query parameters—suitable for simple and complex API calls alike.
  • Caching: Optionally caches responses to improve performance and reduce redundant API calls.
  • Form Data Support: Easily submit form-encoded data for compatible endpoints.
  • Agent-Friendly: Define tool names and descriptions so the component can be used as a tool by agent-based AI workflows.

Example Use Cases

  • Retrieve real-time data (e.g., weather, news, finance) from public APIs.
  • Submit information to a third-party service (e.g., CRM, ticketing system).
  • Integrate with custom backend endpoints for data processing or workflow automation.
  • Enable LLM agents to call external APIs as part of their reasoning or task execution.

Summary

The API Request component is an essential building block for any AI process that needs to interact with web services or external data sources. It offers a comprehensive set of configuration options to handle a wide variety of HTTP request scenarios, and its outputs can be used directly or made available as a tool for agent-based AI workflows.

Esempi di modelli di flusso che utilizzano il componente Richiesta API

Per aiutarti a iniziare rapidamente, abbiamo preparato diversi modelli di flusso di esempio che mostrano come utilizzare efficacemente il componente Richiesta API. Questi modelli presentano diversi casi d'uso e best practice, rendendo più facile per te comprendere e implementare il componente nei tuoi progetti.

Domande frequenti

Cosa fa il componente Richiesta API?

Il componente Richiesta API consente al tuo flusso di inviare richieste HTTP (GET, POST, PATCH, PUT) a uno o più URL, permettendoti di collegarti con qualsiasi API esterna o servizio web.

Posso personalizzare gli header e il corpo delle mie richieste API?

Sì, puoi aggiungere header e contenuti del corpo personalizzati per adattarli alla tua API di destinazione. Entrambi possono essere impostati tramite input di dati o dizionari.

Supporta parametri di query e diversi metodi HTTP?

Assolutamente. Puoi aggiungere parametri di query all’URL e scegliere tra vari metodi HTTP, inclusi GET, POST, PATCH e PUT.

Posso memorizzare nella cache le risposte delle API?

Sì, puoi configurare per quanto tempo memorizzare in cache le risposte API oppure disabilitare completamente la cache, offrendo così controllo sulla freschezza dei dati e sulle prestazioni.

Questo componente è adatto per integrare strumenti di terze parti?

Sì, è progettato per un’integrazione fluida con praticamente qualsiasi servizio di terze parti che esponga un’API, rendendolo un componente fondamentale per l’automazione e workflow avanzati.

Collega i Flussi a Qualsiasi API

Inizia ad aggiungere dati in tempo reale, servizi di terze parti o integrazioni personalizzate ai tuoi flussi utilizzando Richiesta API.

Provalo Ora Prenota una demo