ForHosting KIT · Strumenti per sviluppatori

Avanzamento obiettivo passi e passi rimanenti

Trasformi l’obiettivo quotidiano di camminata e i passi registrati finora in un controllo immediato.

● BetaGratis · nel tuo browser

Usalo da WebAPIEmailTelegramApp presto

Il calcolatore restituisce la percentuale completata, il numero esatto di passi ancora necessari e una chiara indicazione del raggiungimento della meta. È adatto a una verifica personale, a un pannello di attività o a un flusso automatizzato per il benessere. Inserisca un obiettivo intero positivo e un conteggio intero non negativo; il risultato resta utile anche quando supera il traguardo.

Inserisca l’obiettivo e i passi registrati oggi

Parta dal traguardo quotidiano che intende raggiungere e dal totale registrato fino a questo momento. Entrambi i valori sono numeri interi, perché i dispositivi di attività contano passi completi. L’obiettivo deve essere maggiore di zero: un valore nullo o negativo non può fungere da denominatore per una percentuale significativa e genera quindi un errore di input. I passi effettuati possono essere zero all’inizio della giornata e possono anche superare la meta dopo una giornata particolarmente attiva. Se possibile, utilizzi il totale di un unico dispositivo. Sommando i dati di orologio e telefono si rischia di conteggiare due volte una parte della passeggiata registrata da entrambi. Lo strumento non ricava un obiettivo dall’età, dalla salute o dall’attività precedente e non stabilisce se una meta sia appropriata. Confronta soltanto i due numeri forniti, rendendo il risultato facile da riutilizzare in un diario, pannello, promemoria o programma personale.

Interpreti la percentuale e il conteggio rimanente

La percentuale di avanzamento si ottiene dividendo i passi effettuati per l’obiettivo e moltiplicando per cento. Completare tre quarti della meta produce, per esempio, il settantacinque per cento. Il valore visualizzato viene arrotondato a due decimali, così i risultati periodici rimangono leggibili e deterministici. I passi rimanenti equivalgono all’obiettivo meno quelli completati, ma non scendono mai sotto zero. Quando Lei raggiunge il traguardo, la risposta indica zero passi mancanti anche se la percentuale supera il cento per cento. La distinzione conserva informazioni utili: la percentuale mostra di quanto è stata oltrepassata la meta, mentre il conteggio rimanente indica quanto manca davvero. Il campo relativo al raggiungimento fornisce uno stato vero o falso utilizzabile da un software per attivare un badge, un messaggio o un flusso. Ogni uscita deriva unicamente dai valori inviati, senza cronologia, dati nascosti o ipotesi.

Utilizzi il risultato in programmi e applicazioni

Un unico risultato può sostenere decisioni diverse. Nel corso della giornata, usi i passi rimanenti per distribuire l’attività tra pause o passeggiate pianificate. In un’applicazione, mostri la percentuale in un indicatore e mantenga vicino il conteggio esatto per offrire contesto. Quando l’obiettivo risulta raggiunto, un flusso può interrompere i promemoria o contrassegnare la giornata come conclusa. Poiché l’avanzamento può superare il cento per cento, eviti di limitarne il valore salvo che il design richieda una barra piena; conservare il numero riconosce l’attività extra e mantiene accurati i resoconti. Questo calcolo volutamente circoscritto non è un consiglio medico, una stima del consumo energetico o una misura della distanza. I dispositivi possono contare diversamente, quindi i confronti giornalieri sono più affidabili con lo stesso sensore. Il browser è comodo per controlli occasionali; l’API costa $0.002 per richiesta e si adatta a report ricorrenti e sistemi automatizzati.

Casi d'uso

Controllare un traguardo personale

Verifichi la percentuale completata e il numero preciso di passi necessari entro la fine della giornata.

Alimentare un pannello di attività

Converta obiettivo e totale del dispositivo in avanzamento, passi rimanenti e stato di completamento.

Gestire i promemoria di movimento

Interrompa automaticamente gli avvisi quando il risultato conferma il raggiungimento della meta quotidiana.

Domande frequenti

Come viene calcolata la percentuale?

I passi effettuati vengono divisi per l’obiettivo e moltiplicati per cento. Il risultato è arrotondato a due decimali.

Che cosa accade se supero l’obiettivo?

La percentuale può superare cento, i passi rimanenti restano a zero e il traguardo risulta raggiunto.

L’obiettivo può essere zero o negativo?

No. Deve essere un numero intero positivo; altrimenti il calcolatore restituisce un errore di input non valido.

I passi effettuati possono essere negativi o frazionari?

No. Devono essere un numero intero non negativo, perché rappresentano unità discrete.

Quanto costa utilizzare l’API?

Ogni richiesta API costa $0.002. Può eseguire lo stesso calcolo deterministico anche nel browser.

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

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

Esempio di richiesta

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

Esempio di risposta

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

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 →