Processar em lote
O flow.batch roda a mesma tarefa sobre uma lista inteira de itens numa única chamada, em vez de você disparar uma por vez. Validar dez mil CPFs, ler cem notas fiscais, resumir mil textos — você manda a lista e recebe cada resultado de volta, identificado.
Mil itens, uma chamada
Precisou validar uma lista de dez mil e-mails ou ler as notas fiscais do mês inteiro? Disparar uma chamada por item funciona, mas te obriga a escrever o laço, controlar o ritmo, juntar os resultados e tratar os que falharam — trabalho de encanação que não tem nada a ver com o seu problema. O lote assume tudo isso: você entrega a lista de uma vez e recebe o conjunto pronto. A repetição vira responsabilidade da capacidade, não sua.
Como o lote entra e sai
Você escolhe a tarefa e manda a lista de itens que ela deve processar. O lote roda item a item, mantém o ritmo por baixo dos panos e devolve os resultados na mesma ordem, cada um amarrado ao seu item de origem — nada de adivinhar qual resposta é de qual entrada. Para listas grandes, o resultado fica pronto para você baixar de uma vez, em vez de chegar em mil pedaços soltos.
O item que falhou não derruba o lote
Numa lista de milhares, é normal um item ou outro dar problema — um CPF malformado, uma imagem ilegível. O lote não joga tudo fora por causa disso: os itens bons voltam com resultado e os que falharam voltam marcados, com o motivo. Você reprocessa só a minoria problemática, em vez de rodar os dez mil de novo. É a diferença entre um lote que entende a vida real e um que trava no primeiro tropeço.
Como o lote é cobrado
São duas parcelas simples: US$ 0,002 pela chamada do lote e, sobre isso, o preço da tarefa em cada item processado. Validar dez mil CPFs, a US$ 0,002 por validação, dá US$ 20 nos itens mais os US$ 0,002 do lote. Você paga pelos itens que rodaram, não pela lista que planejou — e o preço de cada tarefa fica publicado na página dela. Cobrança por uso, sem assinatura.
Casos de uso
Pasta de XMLs vira planilha única
A TecnoSul Soluções Digitais fecha o mês com uma pasta cheia de XMLs de nota fiscal. Um lote lê todos de uma vez e devolve a planilha consolidada — o que Márcia Regina Oliveira abria arquivo por arquivo agora sai numa chamada.
Dez mil CPFs conferidos de uma vez
Uma corretora precisa validar dez mil CPFs de uma base antiga antes de uma campanha. O lote confere a lista inteira e marca os inválidos, em vez de dez mil conferências manuais.
Comprovantes da semana lidos juntos
A Distribuidora Horizonte Verde recebe centenas de comprovantes de entrega por semana. O lote lê cada imagem, extrai data e valor e entrega tudo numa planilha para o fechamento.
Duzentos comentários resumidos
Juliana Nascimento precisa de um resumo de cada um dos duzentos comentários de uma pesquisa. O lote resume todos de uma vez e ela recebe o conjunto pronto para o relatório.
Perguntas frequentes
Qual a diferença entre lote e rodar em paralelo?
O paralelo dispara um punhado de tarefas diferentes ao mesmo tempo; o lote roda a mesma tarefa sobre uma lista longa de itens. Para milhares de itens iguais, o lote é o caminho; para poucas tarefas distintas, o paralelo.
E se alguns itens da lista falharem?
Os que deram certo voltam com resultado e os que falharam voltam marcados, com o motivo. Você reprocessa só esses, sem rodar a lista inteira de novo.
Quanto custa processar uma lista?
US$ 0,002 pela chamada do lote mais o preço da tarefa em cada item. Dez mil CPFs a US$ 0,002 cada dão US$ 20 nos itens, e a conta é sempre pelos itens que rodaram.
Tem limite de tamanho da lista?
O lote foi feito para listas grandes — dos milhares tranquilamente. Para volumes muito acima disso, o melhor é quebrar em lotes ou falar com a gente; escreva para [email protected] que ajustamos o caminho.
Os resultados vêm na mesma ordem da lista?
Vêm, e cada resultado fica amarrado ao seu item de origem. Você não precisa adivinhar qual resposta é de qual entrada — o casamento vem pronto.
Os dados da lista ficam guardados?
A lista é processada para gerar os resultados e serve só para isso. O conjunto volta para você; guardar a base é papel do seu sistema, dentro das regras da LGPD que você já cumpre.
Para desenvolvedores — acesso via API
Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.
Endpoint
Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.
Chame do seu código
curl -X POST https://api.kit.forhosting.com/flow/batch \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"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['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" => '{"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)Exemplo de requisição
{
"items": [
"valor-1",
"valor-2"
]
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "flow.batch",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.
Preço
Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.
Erros
| HTTP | Código | O que significa |
|---|---|---|
401 | unauthorized | Token ausente ou inválido. Confira o header Authorization. |
402 | insufficient_balance | Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo. |
404 | unknown_type | Esse tipo de tarefa não existe. Confira o campo type no catálogo. |
429 | rate_limited | Muitas requisições em pouco tempo. Espere um instante e tente de novo. |