ForHosting KIT · Notifiche e automazioni

Come concatenare più strumenti

flow.chain collega più capacità del KIT in un’unica sequenza: il risultato del primo passaggio diventa l’ingresso del secondo, e così via fino alla fine. Definisci l’ordine una volta sola, poi un’unica chiamata esegue l’intera catena, dalla pagina o via API.

● Stabileper richiesta + per passaggio$0.000

Vedi l'API — $0.000 Vedi l'API

Usalo da WebAPIEmailApp prestoTelegram presto

Un lavoro in più fasi, un solo comando

Tanti compiti richiedono più passaggi in sequenza: leggere un documento, estrarne i dati, mandare un avviso. Presi uno per uno, ogni passaggio obbliga a prendere il risultato del precedente e passarlo manualmente al successivo. flow.chain toglie questo lavoro di raccordo: metti i passaggi nell’ordine giusto, ognuno riceve automaticamente ciò che ha prodotto quello prima, e l’insieme parte con un solo comando.

Il risultato di uno diventa l’ingresso dell’altro

Il cuore della catena è proprio questo passaggio di testimone: l’output di un passaggio entra direttamente in quello successivo, senza che tu debba intervenire in mezzo. Un PDF letto e trasformato in testo, quel testo riassunto, il riassunto mandato via email — tre capacità distinte diventano un unico flusso continuo. Se un passaggio fallisce, la catena si ferma lì e segnala esattamente dove.

Combinarla con altre funzioni

Definisci la catena da questa pagina, oppure via API per integrarla nel tuo sistema. Una volta definita, la riesegui tutte le volte che serve su dati diversi. Si combina bene con un’attività ricorrente programmata per farla partire a orario fisso, oppure con il ritentativo automatico per assorbire un errore temporaneo senza fermare l’intero flusso a metà lavoro, ogni volta da capo.

Come si calcola il prezzo

Una catena non ha un prezzo proprio separato: somma il costo di ciascuno dei suoi passaggi e applica una maggiorazione del 20% per il coordinamento. Se i passaggi da soli costano $0.010 in totale, la catena arriva a $0.012, in dollari. Vedi esattamente da dove viene ogni centesimo: il lavoro reale più il servizio di orchestrazione, prezzo pubblicato in anticipo.

Casi d'uso

Dalla fattura ricevuta ai dati archiviati

Tecnoedil Verona S.n.c. collega la lettura di una fattura in PDF, l’estrazione della partita IVA e dell’importo, e l’invio di un riepilogo allo Studio Commercialista Bianchi, tutto in un’unica operazione.

Da un testo lungo a un messaggio breve

Web Agency Nuvola S.r.l. collega la conversione di un verbale di riunione, il suo riassunto e l’invio al cliente via email, senza intervenire tra un passaggio e l’altro.

Da un audio a un articolo pubblicabile

Un promemoria vocale registrato da Luca Esposito viene trascritto, ripulito e trasformato in bozza d’articolo: ogni passaggio passa il proprio risultato a quello successivo automaticamente.

Domande frequenti

Cosa succede se un passaggio fallisce a metà catena?

La catena si ferma al passaggio che ha fallito e ti indica quale. I passaggi già completati hanno prodotto il loro risultato; quelli successivi non partono. Collegando il ritentativo automatico, puoi far riprovare il passaggio fallito prima di arrenderti.

Quanti passaggi posso mettere in una catena?

Componi la sequenza che serve al tuo caso, da due passaggi a una serie più lunga. Ogni passaggio aggiunge il proprio costo al totale: è l’utilità del flusso, più che il numero, a guidarne la lunghezza.

Perché una maggiorazione del 20% sulla somma dei passaggi?

Copre il coordinamento: il passaggio dei dati da uno step all’altro, il rispetto dell’ordine, l’interruzione pulita in caso di errore. Paghi il lavoro dei singoli passaggi più questo servizio di orchestrazione, indicato in modo esplicito invece che nascosto in un prezzo unico.

I dati passano sui vostri server durante la catena?

Sì: l’esecuzione avviene lato server, con ogni risultato che passa al passaggio successivo senza tornare da te. I dati servono solo al flusso descritto e a nient’altro. Metti in catena solo le informazioni necessarie, nel rispetto del GDPR.

Posso riusare la stessa catena su dati diversi?

Sì. Una catena si definisce una volta e si rilancia quante volte serve, con un ingresso diverso a ogni esecuzione: è quello che la distingue da un’operazione fatta a mano una volta sola.

Che differenza c’è con l’esecuzione in parallelo?

La catena tratta i passaggi uno dopo l’altro perché ognuno dipende dal risultato del precedente. Quando i compiti sono indipendenti e possono girare contemporaneamente, l’esecuzione in parallelo è più veloce e più adatta.

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/chain

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/chain \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"input":"…"}'

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

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/flow/chain",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "input": "…"
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"input":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/flow/chain", 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

{
  "input": "…"
}

Esempio di risposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "flow.chain",
  "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.000

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 →