Nura

Nura для разработчиков

Подключите заботу о близких к своему продукту

Партнёрский API отдаёт пульс, активность, сон и тревоги с браслетов Nura. Встраивайте данные в панель сиделки, страховой сервис, умный дом или исследование. Доступ по ключу, чтение по REST, события через вебхуки.

Запросить доступСмотреть эндпоинты

API доступен по заявке. Ключи и данные выдаются только по пациентам, которые дали согласие на передачу.

Что можно построить

Патронаж и телемедицина

Показывайте пульс, сон и активность подопечных в панели сиделки или врача. Реагируйте на тревоги раньше, чем поступит звонок.

Страховые продукты

Подключайте данные о ежедневной активности и падениях к программам страхования жизни и здоровья пожилых.

Умный дом и панели

Выводите состояние близкого на домашний планшет, ТВ-панель или в сценарии умного дома рядом с остальными датчиками.

Исследования и аналитика

Выгружайте обезличенные временные ряды пульса и сна для клинических и продуктовых исследований (по отдельному соглашению).

Быстрый старт

1

Запросите доступ

Напишите нам о продукте и сценарии. Мы заводим партнёрский аккаунт и выдаём тестовый и боевой ключи.

2

Авторизуйтесь

Передавайте ключ в заголовке Authorization. Ключ привязан к пациентам, которые дали согласие на передачу данных.

3

Читайте данные

Запрашивайте устройства, показатели, сон и тревоги по REST. На события подписывайтесь через вебхуки.

Авторизация

Все запросы идут на боевой адрес и требуют ключ в заголовкеAuthorization. Ключ видаnura_live_… привязан к вашему партнёрскому аккаунту и к списку пациентов, открывших доступ. Тестовый ключ (nura_test_…) работает на демо-данных.

Базовый адрес

https://api.nura-zabota.ru/v1

Пример запроса

curl https://api.nura-zabota.ru/v1/partner/bands \
  -H "Authorization: Bearer nura_live_9d1f...c204"

Эндпоинты

Версия v1. Все ответы в формате JSON, время в UTC (ISO 8601).

Устройства и статус

Список браслетов, к которым у ключа есть доступ, и их текущее состояние: онлайн, заряд, версия прошивки.

GET/v1/partner/bands

Список доступных браслетов.

Ответ

{
  "bands": [
    {
      "id": "band_9f3a2b",
      "alias": "Мама",
      "online": true,
      "battery": 74,
      "firmware": "1.8.2",
      "lastSeen": "2026-08-26T09:41:12Z"
    }
  ]
}
GET/v1/partner/bands/{bandId}

Статус одного браслета.

Ответ

{
  "id": "band_9f3a2b",
  "alias": "Мама",
  "online": true,
  "battery": 74,
  "firmware": "1.8.2",
  "lastSeen": "2026-08-26T09:41:12Z"
}

Пульс и активность

Текущие и исторические показатели: пульс, шаги, уровень активности. Временной ряд задаётся параметрами from и to (ISO 8601).

GET/v1/partner/bands/{bandId}/vitals?from=&to=

Временной ряд показателей за период. Без from/to возвращаются последние сутки.

Ответ

{
  "bandId": "band_9f3a2b",
  "samples": [
    { "ts": "2026-08-26T09:40:00Z", "hr": 72, "steps": 1840, "activity": "light" },
    { "ts": "2026-08-26T09:45:00Z", "hr": 75, "steps": 1902, "activity": "light" }
  ]
}
GET/v1/partner/bands/{bandId}/vitals/latest

Последнее измерение по браслету.

Ответ

{
  "bandId": "band_9f3a2b",
  "ts": "2026-08-26T09:45:00Z",
  "hr": 75,
  "steps": 1902,
  "activity": "light"
}

Сон

Ночной сон и дневной сон (наппы) за дату: время засыпания и пробуждения, длительность, оценка качества.

GET/v1/partner/bands/{bandId}/sleep?date=

Сводка сна за ночь на указанную дату (по умолчанию последняя завершённая ночь).

Ответ

{
  "bandId": "band_9f3a2b",
  "date": "2026-08-26",
  "start": "2026-08-25T22:14:00Z",
  "end": "2026-08-26T06:03:00Z",
  "minutes": 469,
  "quality": "good",
  "naps": [
    { "start": "2026-08-26T13:20:00Z", "end": "2026-08-26T14:05:00Z", "minutes": 45 }
  ]
}

Тревоги

События, требующие внимания: детект падения, SOS, уход устройства в офлайн. Читайте историей или получайте в реальном времени через вебхуки.

GET/v1/partner/alerts?from=&to=&type=

История тревог. type: fall | sos | offline.

Ответ

{
  "alerts": [
    {
      "id": "alert_7c1e",
      "bandId": "band_9f3a2b",
      "type": "fall",
      "ts": "2026-08-26T08:12:44Z",
      "resolved": false
    }
  ]
}

Вебхуки

Чтобы получать тревоги в реальном времени, укажите URL вашего сервиса. На каждое событие Nura отправляет POST с JSON. Проверяйте подпись из заголовка X-Nura-Signature (HMAC-SHA256 тела вашим секретом вебхука), прежде чем доверять данным. Отвечайте статусом 2xx; при ошибке мы повторяем доставку с нарастающей задержкой.

POST https://your-service.example/webhooks/nura
X-Nura-Signature: sha256=3b8a...e91f

{
  "event": "alert.created",
  "id": "alert_7c1e",
  "bandId": "band_9f3a2b",
  "type": "fall",
  "ts": "2026-08-26T08:12:44Z"
}

Типы событий: alert.created (падение и SOS),device.offline,device.online.

Ошибки и лимиты

Формат ошибки

{
  "error": {
    "status": 403,
    "code": "forbidden",
    "message": "No access to this band"
  }
}

Коды

400
invalid_request: Некорректные параметры запроса.
401
unauthorized: Ключ отсутствует или недействителен.
403
forbidden: У ключа нет доступа к этому пациенту или ресурсу.
404
not_found: Ресурс не найден.
429
rate_limited: Превышен лимит запросов.

Лимиты и постраничность

  • До 120 запросов в минуту на ключ. При превышении приходит 429 с заголовком Retry-After.
  • Длинные выборки листаются параметрами limit и cursor; следующий курсор возвращается в поле nextCursor.
  • Период в запросах истории ограничен 31 днём за один вызов.

SDK

REST работает из любого языка. Официальные обёртки для JavaScript, Swift и Kotlin в разработке: они берут на себя авторизацию, подпись вебхуков и типы ответов. Нужен ранний доступ к SDK под свою платформу? Напишите нам, подключим в первую очередь.

Запросить доступ

Расскажите о продукте и о том, какие данные нужны. Мы заведём партнёрский аккаунт, выдадим ключи и поможем с интеграцией.

Написать нам

Или на почту support@nura-zabota.ru

Проверяем наличие…