ForHosting KIT · Notifiche e automazioni

Elabora centinaia di file in un colpo solo

flow.batch applica la stessa operazione a un intero gruppo di file o dati — cento immagini, mille righe, cinquanta PDF — in un’unica esecuzione, invece di ripetere il comando manualmente per ogni singolo elemento della lista, uno alla volta, come si farebbe a mano.

● Stabileper richiesta + per elemento$0.002

Vedi l'API — $0.002 Vedi l'API

Usalo da WebAPIEmailApp prestoTelegram presto

La stessa operazione, ripetuta cento volte

Ridimensionare un’immagine è un’operazione semplice; ridimensionarne trecento a mano, una alla volta, è un pomeriggio perso. flow.batch prende una lista di elementi — file, righe, indirizzi — e applica a ciascuno la stessa operazione, restituendo tutti i risultati insieme. Il comando resta uno solo; è il volume di lavoro dietro a cambiare scala, non lo sforzo richiesto a chi lo avvia.

Come si passa il gruppo di elementi

Fornisci l’elenco degli elementi da elaborare — un archivio di file, un elenco di indirizzi, le righe di un foglio — e indichi quale operazione applicare a ciascuno. Il sistema esegue l’operazione su ogni elemento e restituisce un risultato per ognuno, insieme a un riepilogo di quanti sono andati a buon fine e quanti hanno avuto un errore, con il dettaglio del motivo.

Cosa succede se un elemento fallisce

In un gruppo grande, è normale che qualche elemento abbia un problema — un file danneggiato, un dato mancante. flow.batch non ferma l’intero gruppo per un singolo errore: prosegue con gli altri elementi e segnala chiaramente quali sono falliti, così puoi occuparti solo delle eccezioni invece di rilanciare tutto da capo, dall’inizio, sprecando tempo ed elaborazioni già riuscite senza motivo.

Prezzo per elemento, senza soglia minima

Ogni elemento elaborato costa $0.002, indipendentemente dal tipo di operazione applicata. Trecento file elaborati in blocco costano $0.60 in totale: paghi esattamente per il numero di elementi nel gruppo, senza un costo fisso per l’esecuzione in sé, indipendentemente da quanto dura l’elaborazione complessiva o da quanti minuti impiega a finire, che siano dieci o diecimila elementi da elaborare in un colpo solo.

Casi d'uso

Trecento foto prodotto ridimensionate insieme

Un negozio online che vende su più marketplace ridimensiona in un colpo solo tutte le foto prodotto caricate durante la settimana, invece di aprire ogni immagine una per una.

Verifica di partita IVA per un elenco di fornitori

Tecnoedil Verona S.n.c. verifica in blocco la partita IVA di tutti i fornitori registrati nell’ultimo trimestre, ottenendo l’esito di ciascuno in un unico riepilogo.

Mille righe di un foglio Excel normalizzate insieme

Consulenza IT Marchetti S.r.l. normalizza in blocco i nomi e gli indirizzi di mille clienti importati da un vecchio sistema, correggendo formati diversi in un’unica esecuzione.

Domande frequenti

C’è un limite al numero di elementi che posso elaborare in blocco?

Il limite pratico dipende dal tipo di operazione applicata a ciascun elemento; per gruppi molto grandi, oltre le poche migliaia di elementi, scrivici prima per verificare i tempi previsti.

Cosa succede se alcuni elementi del gruppo falliscono?

Gli altri elementi vengono comunque elaborati normalmente: ricevi un risultato per ogni elemento riuscito e un elenco chiaro di quelli falliti, senza dover rilanciare l’intero gruppo.

Quanto costa elaborare mille elementi in blocco?

$2.00, a $0.002 per elemento, indipendentemente dal tipo di operazione applicata a ciascuno.

Posso applicare operazioni diverse a elementi diversi nello stesso gruppo?

flow.batch applica la stessa operazione a tutti gli elementi del gruppo. Se ti serve smistare elementi diversi verso operazioni diverse, combina questa capacità con un flusso condizionale a monte.

Il risultato arriva tutto insieme o elemento per elemento man mano?

Puoi consultare l’esito complessivo alla fine dell’elaborazione oppure, per gruppi grandi, seguire l’avanzamento mentre gli elementi vengono completati uno alla volta.

Per sviluppatori — accesso via API

Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.

Endpoint

POSThttps://api.kit.forhosting.com/flow/batch

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

Chiamala dal tuo stack

curl -X POST https://api.kit.forhosting.com/flow/batch \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"items":["valor-1","valor-2"]}'

const res = await fetch("https://api.kit.forhosting.com/flow/batch", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "items": [
      "valor-1",
      "valor-2"
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/flow/batch",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "items": [
        "valor-1",
        "valor-2"
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/flow/batch", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => &#39;{"items":["valor-1","valor-2"]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"items":["valor-1","valor-2"]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/flow/batch", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Esempio di richiesta

{
  "items": [
    "valor-1",
    "valor-2"
  ]
}

Esempio di risposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "flow.batch",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.

Prezzi

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

Errori

HTTP	Codice	Significato
`401`	`unauthorized`	Chiave API mancante o non valida: controlla l'header Authorization.
`402`	`insufficient_balance`	Credito esaurito: ricarica per continuare a eseguire attività.
`404`	`unknown_type`	Tipo di attività sconosciuto: controlla il campo type della richiesta.
`429`	`rate_limited`	Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →