ForHosting KIT · Outils pour développeurs

Progression de l’objectif quotidien et pas restants

Transformez un objectif quotidien de marche et le nombre de pas déjà enregistré en bilan immédiat.

● BetaGratuit · dans votre navigateur

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Le calculateur indique le pourcentage accompli, le nombre exact de pas encore nécessaires et si l’objectif est atteint. Il convient à une consultation personnelle, à un tableau de suivi ou à un processus automatisé de bien-être. Saisissez un objectif entier positif et un total entier non négatif ; le résultat reste pertinent même lorsque vous dépassez votre cible.

Saisissez l’objectif et les pas enregistrés aujourd’hui

Commencez par l’objectif quotidien que vous souhaitez atteindre et le total relevé jusqu’à présent. Les deux valeurs sont des nombres entiers, car les bracelets et téléphones comptent des pas complets. L’objectif doit être supérieur à zéro : une cible nulle ou négative ne peut pas servir de dénominateur à un pourcentage pertinent et provoque donc une erreur de saisie. Le total effectué peut être nul au début de la journée et dépasser l’objectif après une journée particulièrement active. Dans la mesure du possible, utilisez toujours le relevé d’un même appareil. Additionner une montre et un téléphone risque de compter deux fois une partie du trajet. Cet outil ne déduit aucun objectif selon l’âge, l’état de santé ou l’activité antérieure et n’évalue pas la pertinence de votre cible. Il compare uniquement les deux nombres fournis afin que vous puissiez réutiliser le résultat dans un journal, un tableau de bord, un rappel ou une routine personnelle.

Interprétez le pourcentage et le nombre restant

Le pourcentage de progression correspond au nombre de pas effectués divisé par l’objectif, puis multiplié par cent. Réaliser trois quarts de la cible donne ainsi soixante-quinze pour cent. La valeur est arrondie à deux décimales afin que les résultats périodiques restent lisibles et déterministes. Les pas restants correspondent à l’objectif moins le total accompli, sans jamais descendre sous zéro. Une fois la cible atteinte, la réponse indique zéro pas restant même si le pourcentage dépasse cent pour cent. Cette distinction conserve une information utile : le pourcentage mesure le dépassement, tandis que le nombre restant répond directement à ce qu’il reste à faire. Le champ indiquant l’objectif atteint fournit un état vrai ou faux qu’un logiciel peut employer pour déclencher un badge, un message ou un processus. Chaque sortie dépend exclusivement des valeurs transmises, sans historique de compte, données cachées ni hypothèses supplémentaires.

Exploitez le résultat dans vos routines et applications

Un même résultat peut guider plusieurs décisions. Pendant la journée, répartissez les pas restants entre vos pauses ou promenades prévues. Dans une application, affichez le pourcentage dans une jauge tout en conservant le nombre exact à proximité pour donner du contexte. Lorsque l’objectif est déclaré atteint, un processus peut arrêter les rappels ou marquer la journée comme terminée. Puisque la progression peut dépasser cent pour cent, évitez de plafonner sa valeur sauf si la conception d’une barre l’exige ; conserver le chiffre complet reconnaît l’activité supplémentaire et améliore les rapports. Ce calcul volontairement ciblé ne constitue ni un avis médical, ni une estimation énergétique, ni une mesure de distance. Les appareils détectent parfois les mouvements différemment : les comparaisons sont donc plus fiables avec le même capteur. Le navigateur convient aux contrôles occasionnels ; l’accès API coûte $0.002 par requête et s’intègre aux rapports récurrents et aux systèmes automatisés.

Cas d’usage

Contrôler un objectif personnel

Consultez le pourcentage accompli et le nombre précis de pas nécessaires avant la fin de la journée.

Alimenter un tableau d’activité

Convertissez l’objectif et le relevé du capteur en progression, pas restants et état d’achèvement.

Piloter les rappels d’activité

Arrêtez automatiquement les notifications dès que le résultat confirme l’atteinte de la cible quotidienne.

Questions fréquentes

Comment le pourcentage est-il calculé ?

Le total effectué est divisé par l’objectif, puis multiplié par cent. Le résultat est arrondi à deux décimales.

Que se passe-t-il si je dépasse l’objectif ?

Le pourcentage peut dépasser cent, les pas restants restent à zéro et l’objectif est signalé comme atteint.

L’objectif peut-il être nul ou négatif ?

Non. Il doit être un entier positif, faute de quoi le calculateur renvoie une erreur de saisie non valide.

Le total effectué peut-il être négatif ou fractionnaire ?

Non. Il doit s’agir d’un entier non négatif, puisque les pas sont des unités discrètes.

Quel est le tarif de l’API ?

Chaque requête API coûte $0.002. Le même calcul déterministe est également disponible dans votre navigateur.

Pour les développeurs — accès API

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

Endpoint

POSThttps://api.kit.forhosting.com/final3/step-goal-progress-percent

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

Appeler depuis votre 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)

Exemple de requête

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

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "final3.step_goal_progress_percent",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

Tarifs

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

Erreurs

HTTP	Code	Signification
`401`	`unauthorized`	Clé API absente ou invalide : vérifiez l’en-tête Authorization.
`402`	`insufficient_balance`	Solde insuffisant : rechargez votre compte pour lancer cette tâche.
`404`	`unknown_type`	Type de tâche inconnu : vérifiez le champ type de votre requête.
`429`	`rate_limited`	Trop de requêtes : ralentissez la cadence, puis réessayez.

Consulter la documentation complète du KIT →