ForHosting KIT · Ferramentas para dev

Calculadora de cochilo ideal

A calculadora de tempo ideal de cochilo transforma um horário inicial no formato de 24 horas em duas opções claras de alarme: um cochilo restaurador curto de 20 minutos e outro de ciclo completo de 90 minutos.

● BetaGrátis · no seu navegador

Executar grátis Ver a API

Use pelo WebAPIE-mailTelegramApp em breve

Ela mostra o horário exato de término de cada alternativa e informa quando o resultado cai no dia seguinte. O cálculo é imediato, determinístico e voltado ao planejamento, não ao diagnóstico. Escolha a opção curta quando a sua pausa for limitada ou compare-a com a opção longa quando houver tempo para um ciclo de sono completo.

Escolha a recomendação adequada ao tempo disponível

Informe a hora e o minuto em que você espera começar o cochilo, usando o formato de 24 horas. A calculadora apresenta duas alternativas bem diferentes porque uma única duração não atende a todas as situações. A recomendação restauradora curta termina 20 minutos após o horário inicial e foi pensada para uma pausa compacta. A recomendação de ciclo completo termina 90 minutos depois e oferece uma janela maior, baseada em uma estimativa comum de ciclo de sono. Compare os dois horários finais com o seu próximo compromisso e considere também o tempo necessário para se acomodar e recuperar a atenção ao acordar. A ferramenta soma somente a duração declarada; ela não inclui silenciosamente uma estimativa do tempo para adormecer. Caso você normalmente demore alguns minutos para pegar no sono, informe o horário em que realmente espera dormir ou acrescente esse intervalo ao configurar o alarme.

Entenda o horário final e a passagem da meia-noite

Cada recomendação inclui a duração, um horário final formatado, valores separados de hora e minuto e um deslocamento de dia. Deslocamento zero significa que o cochilo termina no mesmo dia do início. O valor um indica que o cálculo passou da meia-noite e que o horário exibido pertence ao dia seguinte. Essa distinção é importante em descansos noturnos: um cochilo iniciado às 23:30 não termina em um momento anterior do mesmo dia apenas porque o relógio reiniciou. Os campos numéricos separados também ajudam sistemas que criam lembretes ou comparam agendas sem precisar interpretar texto formatado. As entradas são verificadas com rigor. A hora deve ser um número inteiro entre 0 e 23, e os minutos, um inteiro entre 0 e 59. Campos ausentes, textos numéricos, decimais, infinitos e outros valores não numéricos são rejeitados para impedir que uma solicitação inválida produza um resultado aparentemente confiável.

Use o resultado como apoio ao planejamento

A reação a um cochilo varia conforme o débito de sono, a idade, a saúde, o ambiente, os medicamentos, a cafeína e os hábitos individuais. Portanto, os dois resultados são recomendações de horário, não promessas de disposição nem orientação médica. O cálculo determinístico é especialmente útil quando a consistência importa: o mesmo horário inicial válido sempre gera os mesmos dois finais, tanto no navegador quanto pela API. Isso atende rotinas pessoais, calendários, aplicativos de bem-estar e planejadores de pausas que precisam de aritmética transparente. Avalie o contexto antes de seguir o resultado e reserve tempo suficiente para despertar completamente antes de dirigir, operar equipamentos ou realizar atividades críticas. Se os cochilos causarem confusão frequente, prejudicarem o sono noturno ou parecerem necessários devido a uma sonolência excessiva persistente, procure um profissional de saúde qualificado, capaz de considerar as suas circunstâncias e o seu histórico médico.

Casos de uso

Planejar um descanso no almoço

Compare o término após 20 minutos com o horário de retorno, sem calcular as horas manualmente.

Configurar um alarme à noite

Veja quando o cochilo atravessa a meia-noite e use o deslocamento de dia para não escolher a data errada.

Incluir opções de cochilo em um aplicativo

Gere horários finais estruturados e estáveis para alternativas restauradoras curtas e de ciclo completo.

Perguntas frequentes

Quais durações a calculadora utiliza?

Ela usa 20 minutos na recomendação restauradora curta e 90 minutos na recomendação de ciclo completo.

O cálculo inclui o tempo necessário para adormecer?

Não. As duas durações são somadas diretamente ao horário informado; planeje separadamente qualquer intervalo para adormecer ou despertar.

O que significa day_offset?

Zero indica que a recomendação termina no mesmo dia. Um indica que ela acaba depois da meia-noite, no dia seguinte.

Por que textos numéricos são rejeitados?

O contrato exige números reais para hora e minuto. A validação rigorosa evita conversões ambíguas e identifica integrações incorretas.

Isso é orientação médica?

Não. É um recurso determinístico de planejamento. Procure um profissional de saúde em caso de problemas persistentes de sono ou sonolência excessiva.

Quanto custa uma solicitação de API?

Cada solicitação de API custa US$ 0,002. A versão no navegador pode ser usada sem enviar o cálculo para a API.

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/health/nap-length

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/health/nap-length \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"start_hour":13,"start_minute":40}'

const res = await fetch("https://api.kit.forhosting.com/health/nap-length", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "start_hour": 13,
    "start_minute": 40
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/health/nap-length",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "start_hour": 13,
    "start_minute": 40
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/health/nap-length", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"start_hour":13,"start_minute":40}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"start_hour":13,"start_minute":40}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/health/nap-length", 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

{
  "start_hour": 13,
  "start_minute": 40
}

Exemplo de resposta

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