Elabora centinaia di file in un colpo solo
Invii un’operazione e un elenco, e ogni elemento torna con il proprio risultato: «Uno Dos» e «Tres» diventano «uno-dos» e «tres» in un unico lavoro. Gli elementi che falliscono vengono ritentati fino a tre volte e non si pagano mai.
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.
Una sola operazione, tutto l’elenco
L’elaborazione in blocco serve per lavori che non sono complicati, solo grandi. Lei sceglie un’operazione, imposta le opzioni comuni a tutti gli elementi e allega l’elenco: ogni voce porta solo il proprio dato, per esempio un titolo di prodotto da tradurre o una pagina scansionata da leggere. Gli elementi vengono trattati contemporaneamente e non uno dopo l’altro, quindi un elenco più lungo non significa un’attesa proporzionalmente più lunga. Alla fine riceve un unico risultato che copre ogni elemento, invece di migliaia di risposte separate da ricomporre a mano.
Quando usarla e gli errori tipici
Gli usi tipici sono tradurre un catalogo per un nuovo mercato, estrarre il testo da un archivio scansionato pagina per pagina o verificare una lunga lista di iscritti. L’errore più comune è mescolare lavori diversi nello stesso blocco: tutti gli elementi eseguono la stessa operazione, quindi passaggi diversi vanno in una catena o in un’esecuzione parallela. L’altro è rimandare l’intero elenco per poche righe sbagliate. Ogni elemento che fallisce viene ritentato fino a tre volte da solo, il risultato indica quali non sono riusciti e perché, e si pagano solo quelli riusciti: basta correggere e rinviare quelli.
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.
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.
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.
Che differenza c’è tra un’elaborazione in blocco e una in parallelo?
Il blocco ripete la stessa operazione su un elenco lungo e uniforme, come migliaia di titoli di prodotti da tradurre. L’esecuzione in parallelo serve per poche operazioni diverse da svolgere nello stesso momento, ciascuna con il proprio compito.
Strumenti correlati
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
Un POST autenticato crea l'attività; il risultato arriva via webhook o con un link firmato. Questa capacità è disponibile via API, non come strumento web interattivo.
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 '{"task_type":"verify.email_mx","items":[{"email":"a@b.com"},{"email":"c@d.com"}]}'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({
"task_type": "verify.email_mx",
"items": [
{
"email": "a@b.com"
},
{
"email": "c@d.com"
}
]
})
});
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['KIT_KEY']}"},
json={
"task_type": "verify.email_mx",
"items": [
{
"email": "a@b.com"
},
{
"email": "c@d.com"
}
]
},
)
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" => '{"task_type":"verify.email_mx","items":[{"email":"a@b.com"},{"email":"c@d.com"}]}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"task_type":"verify.email_mx","items":[{"email":"a@b.com"},{"email":"c@d.com"}]}`)
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
{
"task_type": "verify.email_mx",
"items": [
{
"email": "a@b.com"
},
{
"email": "c@d.com"
}
]
}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
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. |
Note tecniche
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.
Domande tecniche
Quanto costa elaborare mille elementi in blocco?
$2.00, a $0.002 per elemento, indipendentemente dal tipo di operazione applicata a ciascuno.