OpenAPI Connector

action_openapi · action · Utility · Disponibile · v1.0.0

Descrizione

Connettore universale: esegue qualunque API REST descritta da una spec OpenAPI 3.0 (Swagger). Invece di un nodo dedicato per ogni servizio, incolli la spec del provider (Stripe, Slack, Notion, GitHub, il tuo gestionale…) e scegli l'operation: un solo nodo copre migliaia di endpoint. Come funziona: 1) incolla la spec OpenAPI in JSON, 2) indica l'operationId dell'endpoint, 3) passa i parametri (path/query/header) come oggetto JSON. Il nodo costruisce automaticamente l'URL sostituendo i path param (es. /users/{id}), aggiunge query e header, esegue la chiamata e ritorna status + body parsato. Auth: header configurabile (Authorization: Bearer …, X-API-Key, ecc.) con valore tenuto come secret. Base URL preso da servers[] della spec o sovrascrivibile. Timeout configurabile. SSRF-safe (assertUrlSafe) come tutti i nodi HTTP. Use case: (1) integrare un SaaS che ha OpenAPI ma non un nodo dedicato, (2) chiamare un'API interna aziendale documentata, (3) prototipare un'integrazione prima di costruire un community node dedicato. Per chiamate HTTP arbitrarie senza spec usa action_http; per integrazioni con auth OAuth complesso valuta un community node.

⚙️ Parametri di configurazione

Campi mostrati nell’editor quando si configura il nodo. Generati direttamente dal NodeDefconfigFields.

Campo	Tipo	Required	Default	Descrizione
`specJson` Spec OpenAPI 3.0 (JSON)	`JSON object/array`	si	—	La spec del provider in JSON. Da servers[] viene preso il base URL; da paths le operations disponibili.
`operationId` Operation ID	`string`	si	— getUser	L'operationId dell'endpoint da chiamare (come nella spec). Se manca nella spec, usa "METHOD /path" (es. "GET /users").
`baseUrl` Base URL (override)	`string`	no	— https://api.example.com/v1	Sovrascrive il server della spec. Vuoto = primo servers[].url della spec.
`paramsJson` Parametri (JSON)	`JSON object/array`	no	— { "id": "42", "fields": "name,email" }	Oggetto chiave→valore per i parametri path/query/header dell'operation. I path param obbligatori mancanti danno errore.
`bodyJson` Request body (JSON)	`JSON object/array`	no	—	Body inviato per le operations che lo accettano (POST/PUT/PATCH con requestBody). Content-Type application/json automatico.
`authHeader` Header di autenticazione	`string`	no	— Authorization	Nome dell'header auth (es. Authorization, X-API-Key). Vuoto = nessuna auth.
`authValue` Valore autenticazione	`string (encrypted)`	no	— Bearer sk_live_…	Valore dell'header auth. Tenuto come secret.
`timeoutMs` Timeout (ms)	`number`	no	`30000`	Timeout della richiesta in millisecondi. Default 30s.

⬆️ Output del nodo

Campi disponibili nei nodi successivi via $node.<alias>.json.<field>:

status
operationId
data

💡 Esempio configurazione

Snippet JSON del nodo come compare nel workflow. I valori sono derivati daidefaultValue e dai parametri required.

{
  "id": "node-action_openapi-1",
  "defId": "action_openapi",
  "label": "OpenAPI Connector",
  "config": {
    "specJson": "<specJson>",
    "operationId": "getUser",
    "timeoutMs": 30000
  }
}

🔗 Nodi correlati nella stessa categoria

Pronto a usare OpenAPI Connector?

Disponibile da subito in tutti i piani FlowForge. Provalo gratis senza carta di credito.

Inizia gratis Sfoglia tutti i nodi