HTTP Request

Descrizione

Esegue una richiesta HTTP/HTTPS verso API esterne. Coltellino svizzero per qualunque integrazione vendor non gia\` coperta da un nodo dedicato (action_send_email, community_*, integration_*). Differenza con i sibling: action_http = REST/RPC generico full-feature (auth multipla, body 5 forme, pagination 4 strategie, retry/breaker). Per scraping HTML usa action_web_fetch_advanced (header browser preset, cookie jar, anti-bot light). Per orchestrazione adaptive con AI extract usa action_scrape_smart (fetch→render→stealth→vision pipeline). Auth supportata: Basic (user:pass base64), Bearer (token in header), API Key (header custom), Custom (header arbitrari), OAuth2 client_credentials (il nodo ottiene da sé l\`access-token dal token endpoint e lo inietta come Bearer, con cache fino a scadenza). Per il flow OAuth2 authorization_code (a 3 gambe, con redirect utente) usa un nodo integration dedicato. Body: JSON serializzato (con merge di key-value editor), Form url-encoded, Multipart (file upload + campi misti), Raw-text (string custom Content-Type), Raw-binary (base64), Binary (handle da nodo upstream). Pagination automatica con 4 strategie: page-number (?page=N), offset/limit (?offset=N&limit=M), cursor opaco (?cursor=X from response), Link header RFC 5988 (Link: <url>; rel="next"). Walker bounded — maxPages cap protegge da loop infiniti se il vendor implementa Link male. Resilienza enterprise: retry con backoff configurabile (count + delay base + jitter exponential), follow redirects con limit, response format selezionabile (auto-detect via Content-Type / json / text / binary base64), timeout per-request. Wrap automatico con circuit breaker per-host (shared con tutti i nodi che colpiscono lo stesso host — se il vendor e\` giu\`, tutti i workflow si fermano insieme prima di accumulare timeout). Telemetry OpenTelemetry: span per request con method/host/status/duration per dashboard SRE. Use case: (1) chiamata API vendor non coperto da community_* (es. ERP italiano custom), (2) integrazione SaaS interno con auth Bearer + retry idempotente, (3) sync periodico catalogo prodotti con pagination cursor su API REST esterna, (4) webhook outbound notify verso CRM partner con telemetry SLA per audit. Safety budget: SSRF guard via safeOutboundFetch (blocca 127.0.0.1, 10.x/172.16.x/192.168.x, link-local), max response size 50 MB (override per-call), timeout default 30s, retry max 5 attempts, circuit breaker apre su 5 fail consecutivi/30s. Audit log su ogni call con request_id + duration.

⚙️ Parametri di configurazione

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

💡 Esempio configurazione

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

{
  "id": "node-action_http-1",
  "defId": "action_http",
  "label": "HTTP Request",
  "config": {
    "method": "GET",
    "url": "https://api.example.com/v1/users/{{input.id}}",
    "authMode": "none",
    "apiKeyHeaderName": "X-API-Key",
    "customAuthHeaderName": "Authorization",
    "oauth2AuthStyle": "header",
    "bodyType": "json",
    "rawBinaryContentType": "application/octet-stream",
    "paginationMode": "none",
    "paginationMaxPages": 10,
    "paginationPageSize": 50,
    "paginationPageParam": "page",
    "paginationStartPage": 1,
    "paginationLimitParam": "limit",
    "paginationOffsetParam": "offset",
    "paginationStartOffset": 0,
    "paginationCursorParam": "cursor",
    "paginationCursorField": "next_cursor",
    "retryStrategy": "auto",
    "retryCount": 0,
    "retryInitialDelayMs": 500,
    "retryBackoffFactor": 2,
    "retryOnStatus": "429,500,502,503,504",
    "responseFormat": "auto",
    "followRedirects": true,
    "allowSelfSigned": false,
    "statusCodeOnly": false,
    "timeoutMs": 30000,
    "maxResponseMb": 50,
    "throwOnError": true
  }
}

🔗 Nodi correlati nella stessa categoria