Документация v2.4

API для разработчиков CronLab.

Стройте приложения, которые заботятся о здоровье. Получите прямой доступ к метрикам циркадных ритмов, уровню стресса и паттернам сна через RESTful API.

Смотреть эндпоинты Авторизация

Снимок экрана IDE с кодом интеграции CronLab API

Аутентификация и безопасность

Мы используем стандарт OAuth 2.0 для защиты конфиденциальных данных о здоровье пользователей. Все запросы должны быть подписаны вашим секретным ключом.

Получение токена

Отправьте POST-запрос на https://api.cronlab.io/v1/oauth/token с вашими client_id и client_secret в теле запроса (JSON).

Использование в заголовках

Включите полученный Bearer-токен в заголовок каждого запроса:

Authorization: Bearer eyJhbGciOiJIUzI1NiIs...

Безопасность данных

CronLab сертифицирован по стандарту HIPAA. Мы не логируем содержимое ваших запросов. Срок действия токена — 24 часа. Рефреш-токены валидны 30 дней.

Эндпоинты: Сон и Стресс

Основные методы для получения сырых данных и агрегированных аналитических отчетов.

GET /v1/users/{id}/sleep

История сна

Возвращает массив фаз сна (REM, Deep, Light) за заданный период. Поддерживает пагинацию.

• params: start_date, end_date
• response: JSON (array of objects)

GET /v1/users/{id}/stress

Уровень стресса

Данные о вариабельности сердечного ритма (HRV) и расчетный индекс стресса в реальном времени.

• params: interval (1h, 1d, 1w)
• response: JSON (time-series data)

Webhooks: События синхронизации

Вместо постоянного опроса сервера, настройте Webhook URL в панели разработчика. Мы отправим POST-запрос, когда произойдет значимое событие.

Типы событий

sleep.session.ended
Пользователь проснулся. Включает данные о качестве сна.
stress.threshold.exceeded
Уровень стресса превысил 85 баллов в течение 10 минут.

Пример полезной нагрузки (Payload)

{
  "event": "sleep.session.ended",
  "timestamp": "2023-10-27T08:30:00Z",
  "data": {
    "user_id": "usr_8921",
    "quality_score": 92,
    "duration_min": 480,
    "deep_sleep_pct": 22
  }
}

Библиотеки SDK

Ускорьте разработку с помощью официальных пакетов CronLab.

Python

Идеально для анализа данных и интеграции с ML-моделями.


          pip install cronlab-sdk

JavaScript / Node.js

Для веб-приложений и серверной логики на Express/NestJS.


          npm i @cronlab/js

Swift

Для нативных iOS-приложений и виджетов Apple Watch.


          swift package add cronlab

Вопросы по API

Какой лимит запросов (Rate Limit)?

Базовый план позволяет делать 1000 запросов в час. Для enterprise-клиентов с высокими нагрузками лимиты не применяются. Превышение лимита возвращает статус 429.

Как протестировать интеграцию без реальных данных?

Используйте наш режим песочницы (Sandbox). Передайте заголовок X-CronLab-Env: sandbox, и API вернет сгенерированные, но реалистичные данные о здоровье.

Где найти мои API-ключи?

Войдите в личный кабинет разработчика по адресу dev.cronlab.io. Перейдите в раздел "Проекты" и создайте новый ключ для вашего приложения.

Готовы начать разработку?

Получите доступ к документации и своим ключам уже сегодня.

Регистрация разработчика