ForHosting KIT · Santé et sport

Calculateur de sommeil

Organisez votre sommeil en cycles complets de 90 minutes : pour vous réveiller à 07:00 après 5 cycles, avec 15 minutes d'endormissement, couchez-vous à 23:15. Le calcul marche aussi dans l'autre sens, de l'heure du coucher à celle du réveil. Gratuit dans votre navigateur.

Gratuit
Fonctionne dans votre navigateur
Sans inscription
Vos données restent sur votre appareil

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Exemple résolu

Si vous saisissez

Mode de calcul: Calculer l’heure du coucher
Temps: 07:00
Cycles de sommeil: 5
Temps d’endormissement (minutes): 15

Vous obtenez

Durée du cycle (minutes): 90
Horaires suggérés: 23:15, 00:45, 02:15, 03:45, 05:15

Chaque résultat ajoute votre latence d'endormissement et des cycles entiers.

Compter à rebours depuis le réveil

En mode coucher, vous indiquez l'heure à laquelle vous voulez vous réveiller et le calculateur compte à rebours. Il retire de l'heure du réveil les minutes qu'il vous faut pour vous endormir, puis des cycles complets de 90 minutes, avec une proposition par cycle. Avec un réveil à 07:00, 5 cycles et 15 minutes d'endormissement, les heures de coucher sont 23:15, 00:45, 02:15, 03:45 et 05:15. La liste va de l'heure la plus précoce, qui donne le plus de sommeil, à la plus tardive, pour que vous choisissiez combien de repos viser.

Compter en avant depuis le coucher

Le mode réveil fait l'inverse : indiquez l'heure du coucher et le calculateur ajoute vos minutes d'endormissement puis un, deux cycles complets ou plus, en classant les heures de réveil de la plus proche à la plus lointaine. Les heures suivent l'horloge de 24 heures et franchissent minuit sans souci, si bien qu'un coucher tard le soir donne des heures de réveil le lendemain matin. Vous pouvez demander de 1 à 12 cycles, 5 par défaut, et régler le temps d'endormissement sur n'importe quel nombre entier de minutes.

Questions fréquentes

Quel format d'heure attend-il ?

Une chaîne HH:MM sur 24 heures de 00:00 à 23:59. Les heures qui traversent minuit passent correctement au jour suivant dans la sortie.

Combien de suggestions est-ce que j'obtiens ?

Une par cycle, fixé par cycles (5 par défaut, 1 à 12 autorisés). bedtime liste du plus tôt au plus tard ; wake liste du plus proche au plus tardif.

Comment savoir à quelle heure me réveiller si je me couche maintenant ?

Utilisez le mode réveil et indiquez l'heure du coucher. Le calculateur ajoute vos minutes d'endormissement puis un, deux cycles complets de 90 minutes ou davantage, et propose les heures de réveil de la plus proche à la plus lointaine.

À quoi sert le temps d'endormissement ?

Il est compté avant les cycles, car le premier cycle ne commence qu'une fois endormi. Par défaut, c'est 15 minutes ; vous pouvez saisir n'importe quel nombre entier de minutes, zéro compris.

Que se passe-t-il quand l'heure passe minuit ?

Le calcul franchit minuit proprement sur une horloge de 24 heures : avec un réveil à 07:00, la première heure de coucher proposée est 23:15 la veille, sans aucun ajustement de votre part.

Outils associés

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/dev/sleep-calculator

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/dev/sleep-calculator \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mode":"bedtime","time":"07:00"}'

const res = await fetch("https://api.kit.forhosting.com/dev/sleep-calculator", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "mode": "bedtime",
    "time": "07:00"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/dev/sleep-calculator",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "mode": "bedtime",
    "time": "07:00"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/dev/sleep-calculator", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"mode":"bedtime","time":"07:00"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"mode":"bedtime","time":"07:00"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/dev/sleep-calculator", 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

{
  "mode": "bedtime",
  "time": "07:00"
}

Exemple de réponse

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

Notes techniques

À partir d'une heure cible et d'un mode, il liste des heures alignées sur des cycles de sommeil de 90 minutes. mode=bedtime renvoie des heures de coucher pour un réveil cible ; mode=wake renvoie des heures de réveil après un coucher.

Des cycles de quatre-vingt-dix minutes à partir d'une heure d'ancrage

Le champ time est une valeur d'horloge HH:MM sur 24 heures qui devient l'ancre, convertie en minutes depuis minuit. Les heures passent proprement au-delà de minuit à l'aide du modulo 1440 et sont reformatées en HH:MM complété par des zéros. Un cycle de sommeil est fixé à 90 minutes (renvoyé comme cycle_minutes). En mode=bedtime l'ancre est votre heure de réveil souhaitée et l'outil remonte le temps : pour chaque nombre de cycles allant de cycles jusqu'à 1, il calcule ancre moins latency_minutes moins n fois 90, de sorte qu'avec un réveil à 07:00, 5 cycles et 15 minutes de latence vous obtenez des heures de coucher de 23:15, 00:45, 02:15, 03:45 et 05:15. En mode=wake l'ancre est votre heure de coucher et il avance dans le temps : ancre plus latency_minutes plus n fois 90 pour n de 1 à cycles.

Cycles, latence et la liste de suggestions

En mode bedtime la liste va du coucher le plus tôt (le plus de sommeil) au plus tard ; en mode wake du réveil le plus proche au plus tardif. cycles vaut 5 par défaut et doit être un entier de 1 à 12 ; il fixe le nombre de suggestions renvoyées, une par cycle complété, de sorte que vous pouvez choisir la durée totale de sommeil visée. latency_minutes vaut 15 par défaut et doit être un entier non négatif ; il modélise le temps nécessaire pour s'endormir réellement et décale chaque suggestion, puisque le vrai repos commence après que vous vous êtes assoupi, et non à l'instant où vous vous allongez. La réponse reprend mode, l'heure d'ancrage normalisée, cycles, latency_minutes et cycle_minutes à côté du tableau suggestions.

Validation et sortie déterministe

Notez que cet outil prend l'heure d'horloge comme paramètre d'entrée plutôt que de lire l'horloge système, de sorte qu'il ne consulte jamais l'heure réelle du jour et que sa sortie ne dépend que des arguments. Chaque champ est vérifié avant tout calcul horaire. time doit correspondre à un motif strict sur 24 heures (00:00 à 23:59) ; toute autre valeur, y compris un non-chaîne, déclenche une erreur typée invalid_input. Une valeur cycles hors de 1..12 ou non entière, et un latency_minutes négatif ou non entier, sont rejetés de la même manière, tout comme un mode autre que bedtime ou wake et toute entrée non objet.

Cas d'intégration

Planifier l'heure du coucher de ce soir

Saisissez l'heure de votre réveil en mode=bedtime pour voir quelles heures de coucher vous permettent de vous réveiller en fin de cycle plutôt qu'en plein cycle.

Horaires de sieste et de travail posté

Utilisez mode=wake à partir d'une heure de coucher choisie pour trouver des heures de réveil cibles à un à douze cycles de distance, pour des siestes ou des roulements.

Applications de sommeil et de bien-être

Intégrez des suggestions alignées sur les cycles dans une application ou un bot via l'API, en ajustant latency_minutes par utilisateur pour des conseils personnalisés.

Questions techniques

Combien de temps dure un cycle ?

Un cycle fixe de 90 minutes, indiqué dans la réponse comme cycle_minutes. Les suggestions sont espacées d'un cycle.

À quoi sert latency_minutes ?

C'est le temps que vous mettez à vous endormir (15 par défaut). Il décale chaque heure suggérée de sorte que les cycles soient comptés à partir du moment où vous vous assoupissez réellement.

Est-ce gratuit et combien coûte l'API ?

Le widget de navigateur est gratuit ; l'API utilise un solde KIT prépayé à partir de $0.002, et les tâches échouées ne sont pas facturées.

Consulter la documentation complète du KIT →

Lancer gratuitement