ForHosting KIT · Ferramentas para dev

Orçamento de mercado por refeição e categoria

Transforme o valor total disponível para compras em uma meta prática para cada refeição planejada.

● BetaGrátis · no seu navegador

Use pelo WebAPIE-mailTelegramApp em breve

Informe o orçamento e quantas refeições ele deve cobrir; você receberá uma média por refeição e limites claros para proteínas, hortifrúti e demais produtos. A divisão padrão destina 30 por cento a proteínas, 30 por cento a hortifrúti e 40 por cento a outros itens. O resultado não depende de moeda: reais, dólares, euros ou outra unidade funcionam desde que você use sempre a mesma.

Comece pelo valor que você realmente pode gastar

Use todo o dinheiro disponível para o período planejado, e não um valor ideal ou uma renda futura. Depois conte as refeições que os mantimentos precisarão cobrir nesse mesmo intervalo. Uma semana pode ter sete cafés da manhã, cinco almoços levados de casa e sete jantares, com dois almoços feitos fora: são dezenove refeições. A calculadora divide o orçamento por essa quantidade e arredonda para o centavo mais próximo. O número é uma média para planejamento, não uma obrigação de gastar igual em cada prato. Uma sopa barata pode abrir espaço para um jantar mais caro. Lanches, bebidas e reposições da despensa devem entrar como refeições ou na categoria outros, mas você deve manter o critério. Orçamento zero é válido para simulações; a quantidade de refeições precisa ser um inteiro positivo. Usar o mesmo período para ambos evita dividir um orçamento mensal por apenas uma semana e obter uma meta enganosa.

Trate as metas por categoria como referências

A visão por categoria reserva 30 por cento para proteínas, 30 por cento para hortifrúti e os 40 por cento restantes para outros alimentos. Proteínas podem incluir carne, peixe, ovos, laticínios, tofu, feijão ou lentilha. Hortifrúti abrange frutas, legumes e verduras frescos, congelados ou enlatados. Outros comporta grãos, pães, óleos, temperos, molhos, bebidas, lanches e itens básicos. Essas faixas orientam gastos, não a nutrição: mostram quanto dinheiro cabe em cada parte da compra, e não quantas calorias ou porções você deve consumir. Como preços variam, uma família vegetariana pode gastar menos com proteínas e transferir a sobra. Comprar azeite pode elevar outros em uma semana, embora o produto dure meses. Avalie todo o período, não um único cupom. Os valores são calculados em centavos, e qualquer resto de arredondamento fica em outros para que as três categorias correspondam exatamente ao orçamento informado. Cada categoria também apresenta a média por refeição.

Leve o resultado para a lista de compras

Depois de conhecer a média por refeição, relacione os pratos e estime os ingredientes. Refeições caras podem continuar no plano quando equilibradas por aveia, feijão, macarrão ou sobras. Antes de finalizar a compra, compare a lista com as metas de proteínas e hortifrúti. Se uma categoria estiver acima, procure substituições dentro dela: troque um corte premium, escolha vegetais da estação, use congelados ou selecione ingredientes presentes em várias receitas. O resultado não garante preços acessíveis em sua região. Ele não conhece valores da loja, tamanhos de embalagem, restrições alimentares, cupons, estoque doméstico nem quantas pessoas compartilham o prato. É uma base estável para tornar essas decisões visíveis. Recalcule quando o dinheiro ou o número de refeições mudar, sobretudo por viagens, visitas, escola ou refeições fora. A mesma conta determinística está disponível pela API por US$ 0,002 por solicitação. Sem dados externos, entradas iguais sempre retornam as mesmas metas e quantias.

Casos de uso

Planejar a compra semanal

Converta um limite semanal em uma média realista para cada café da manhã, almoço e jantar preparado.

Conferir o equilíbrio das categorias

Compare a lista com metas distintas de proteínas e hortifrúti antes de fechar o carrinho.

Montar cenários de orçamento

Altere o total ou as refeições para comparar planos quando agenda, visitas ou recursos mudarem.

Perguntas frequentes

Qual divisão percentual é usada?

A ferramenta destina 30 por cento a proteínas, 30 por cento a hortifrúti e 40 por cento a outros itens.

A calculadora exige alguma moeda?

Não. Use qualquer moeda, mas mantenha a mesma unidade no total e nas comparações.

Por que refeições devem ser um inteiro positivo?

A média exige pelo menos uma refeição, e eventos planejados são contados como unidades completas.

As metas são orientação nutricional?

Não. Elas são apenas referências de gasto e não substituem aconselhamento alimentar, médico ou nutricional.

Quanto custa a solicitação da API?

A API custa US$ 0,002 por solicitação. O cálculo é fixo e determinístico, sem preços em tempo real.

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

POSThttps://api.kit.forhosting.com/final3/grocery-budget-per-meal

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/final3/grocery-budget-per-meal \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"total_budget":240,"meals":20}'

const res = await fetch("https://api.kit.forhosting.com/final3/grocery-budget-per-meal", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "total_budget": 240,
    "meals": 20
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/final3/grocery-budget-per-meal",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "total_budget": 240,
    "meals": 20
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/final3/grocery-budget-per-meal", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"total_budget":240,"meals":20}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"total_budget":240,"meals":20}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/final3/grocery-budget-per-meal", 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

{
  "total_budget": 240,
  "meals": 20
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "final3.grocery_budget_per_meal",
  "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

por chamadaUS$ 0,002

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.

Ver a documentação completa do KIT →