KeepHabits API · v1 · Pro

Tu rutina, conectada

Automatiza tus registros y consulta tu progreso con la API pública de KeepHabits. Incluida en Pro.

Primeros pasos

1Crea un token en Configuración → Datos y seguridad → API pública. Usa solo lectura salvo que tu integración necesite completar hábitos.
2Guarda el token de forma segura y envíalo en la cabecera Authorization: Bearer. Utilízalo desde tu servidor o automatización; no lo incluyas en una web pública.
3Consulta tus hábitos para obtener su ID. Para marcar o desmarcar, envía el valor completed; repetir la misma petición mantiene el mismo resultado.

URL base

https://keephabits.app/api/v1

Consultar hábitos

curl "https://keephabits.app/api/v1/habits?limit=50" \
  -H "Authorization: Bearer $KEEPHABITS_API_TOKEN"

Completar un hábito

curl -X PUT \
  "https://keephabits.app/api/v1/habits/HABIT_ID/checkins/YYYY-MM-DD" \
  -H "Authorization: Bearer $KEEPHABITS_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"completed":true,"timezone":"Europe/Madrid"}'

Qué puedes hacer

GET/habits

Consultar hábitos activos, su calendario y pausas.

GET/categories

Consultar categorías no eliminadas.

GET/checkins?from=YYYY-MM-DD&to=YYYY-MM-DD

Consultar registros en un intervalo de hasta 365 días.

GET/progress?date=YYYY-MM-DD

Consultar los hábitos programados y completados de una fecha. Respeta pausas y calendario.

PUT/habits/{id}/checkins/{date}

Marcar (true) o desmarcar (false) un hábito. Requiere permiso de escritura.

Límites y fechas

60 peticiones por minuto y token, compartidas entre todas las operaciones. Hay también protección adicional por IP. Si recibes 429, espera los segundos de Retry-After. Las listas usan limit (1–100) y offset; has_more indica si hay otra página.

Fechas YYYY-MM-DD. Indica timezone con un nombre IANA, por ejemplo Europe/Madrid; por defecto se usa UTC. Progreso y escritura admiten los últimos 365 días, sin fechas futuras. No se permite marcar hábitos archivados, eliminados, pausados o no programados. Se puede desmarcar un registro anterior de un día pausado.

El token tiene su propia caducidad (hasta 365 días). El acceso requiere Pro activo en cada petición. Al renovar Pro, los tokens vigentes vuelven a funcionar; los revocados no. Los tokens no permiten cambiar hábitos, eliminar datos ni gestionar pagos.

Respuestas de error

400: parámetros inválidos. 401: token ausente, inválido, revocado o caducado. 403: Pro inactivo o permiso insuficiente. 404: hábito no disponible. 422: fecha o calendario no válido. 429: límite de peticiones. 503: servicio temporalmente no disponible.

Las respuestas privadas y los tokens no se almacenan en caché. La API devuelve datos de tu rutina; nunca claves de Supabase ni información de pago.