ForHosting KIT · Ferramentas para dev

Progresso da meta diária de passos e passos restantes

Transforme uma meta diária de caminhada e os passos registrados até agora em uma verificação imediata.

● BetaGrátis · no seu navegador

Use pelo WebAPIE-mailTelegramApp em breve

A calculadora informa o percentual concluído, a quantidade exata que ainda falta e se o objetivo já foi alcançado. Ela atende tanto a uma consulta pessoal quanto a um painel de atividade ou fluxo automatizado de bem-estar. Informe uma meta inteira positiva e uma contagem inteira não negativa; o resultado continua útil mesmo quando você ultrapassa o objetivo.

Informe a meta e os passos registrados hoje

Comece com o objetivo diário que você pretende alcançar e o total registrado até o momento. Os dois valores devem ser números inteiros, pois os monitores de atividade contam passos completos. A meta precisa ser maior que zero: um alvo nulo ou negativo não pode ser o denominador de um percentual significativo e, portanto, gera um erro de entrada. A contagem realizada pode ser zero no início do dia e também pode superar a meta depois de um dia muito ativo. Sempre que possível, use o total de um único monitor. Misturar os dados de um relógio e de um celular pode contar parte da caminhada duas vezes quando ambos a registram. A ferramenta não deduz uma meta com base em idade, saúde ou atividade anterior, nem avalia se determinado alvo é adequado. Ela apenas compara os dois números fornecidos, facilitando o uso do resultado em diário, painel, lembrete ou rotina pessoal.

Entenda o percentual e a contagem restante

O percentual de progresso resulta da divisão dos passos realizados pela meta, multiplicada por cem. Por exemplo, completar três quartos do alvo corresponde a setenta e cinco por cento. O valor exibido é arredondado para duas casas decimais, mantendo resultados periódicos legíveis e determinísticos. Os passos restantes são a meta menos a contagem concluída, mas nunca ficam abaixo de zero. Quando você atinge o objetivo, a resposta informa zero restante mesmo que o percentual ultrapasse cem por cento. Essa distinção preserva informações úteis: o percentual mostra quanto você avançou além do alvo, enquanto a contagem restante responde quanto ainda falta. O campo de objetivo alcançado fornece um estado verdadeiro ou falso para que um software acione uma mensagem, selo ou fluxo sem interpretar outros números. Toda saída deriva somente dos valores enviados; nenhum histórico, dado oculto do dispositivo ou suposição participa do cálculo.

Use o resultado em rotinas e aplicativos

Um único resultado pode apoiar várias decisões. Ao longo do dia, use os passos restantes para distribuir a atividade entre pausas ou caminhadas planejadas. Em um aplicativo, mostre o percentual em um indicador e mantenha a contagem exata ao lado para dar contexto. Quando o objetivo alcançado se tornar verdadeiro, um fluxo pode interromper lembretes ou marcar o dia como concluído. Como o progresso pode passar de cem por cento, evite limitar o número, a menos que o design visual exija uma barra cheia; preservar o valor reconhece a atividade extra e mantém relatórios corretos. O cálculo é propositalmente restrito e não representa orientação médica, estimativa de gasto energético ou medição de distância. Contagens variam entre aparelhos, portanto comparações diárias são mais confiáveis com o mesmo monitor. O navegador é prático para consultas ocasionais; a API custa US$ 0,002 por solicitação e atende relatórios recorrentes e sistemas automatizados.

Casos de uso

Verificar uma meta pessoal

Veja o percentual concluído e a quantidade exata necessária antes do fim do dia.

Abastecer um painel de atividade

Converta a meta e o total do monitor em progresso, passos restantes e estado de conclusão.

Controlar lembretes de movimento

Interrompa os avisos automaticamente assim que o resultado confirmar que a meta diária foi atingida.

Perguntas frequentes

Como o percentual de progresso é calculado?

Os passos realizados são divididos pela meta e multiplicados por cem. O resultado é arredondado para duas casas decimais.

O que acontece quando ultrapasso a meta?

O percentual pode superar cem por cento, os passos restantes ficam em zero e o objetivo aparece como alcançado.

A meta pode ser zero ou negativa?

Não. Ela deve ser um número inteiro positivo; caso contrário, a calculadora retorna um erro de entrada inválida.

Os passos realizados podem ser negativos ou fracionários?

Não. A contagem precisa ser um número inteiro não negativo porque passos são unidades discretas.

Quanto custa usar a API?

Cada solicitação de API custa US$ 0,002. Você também pode executar o mesmo cálculo determinístico no navegador.

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/step-goal-progress-percent

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/step-goal-progress-percent \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"step_goal":10000,"steps_taken":6750}'

const res = await fetch("https://api.kit.forhosting.com/final3/step-goal-progress-percent", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "step_goal": 10000,
    "steps_taken": 6750
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/final3/step-goal-progress-percent",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "step_goal": 10000,
    "steps_taken": 6750
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/final3/step-goal-progress-percent", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"step_goal":10000,"steps_taken":6750}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"step_goal":10000,"steps_taken":6750}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/final3/step-goal-progress-percent", 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

{
  "step_goal": 10000,
  "steps_taken": 6750
}

Exemplo de resposta

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