Отправка данных через REST API

Omnismith предоставляют REST API, чтобы скрипты, агенты и автоматические конвейеры могли создавать и обновлять сущности без использования веб-интерфейса.

Аутентификация

Сгенерируйте Персональный токен доступа в настройках аккаунта и передавайте его как Bearer-токен в каждом запросе:

Authorization: Bearer omni_your_token_here

Обновление атрибутов сущности

PUT https://api.omnismith.io/v1/entities/{id}
Content-Type: application/json
Authorization: Bearer omni_your_token_here

{
  "attribute_values": [
    { "attribute_id": "ATTR_UUID", "value": "some value" },
    { "attribute_id": "ANOTHER_ATTR_UUID", "value": 42 }
  ]
}

Каждый элемент в attribute_values должен содержать:

Поле	Обязательное	Описание
`attribute_id`	✓	UUID обновляемого атрибута
`value`	✓	Новое значение — строка, число или boolean
`updated_at`	—	Метка времени ISO 8601; по умолчанию время сервера

Заполнение исторических данных (Backfilling)

Необязательное поле updated_at позволяет записывать значение на определенный момент в прошлом. Это полезно, когда:

Удаленное устройство потеряло связь и буферизовало показания локально
Вы мигрируете исторические данные из другой системы
Вам необходимо зафиксировать показание за конкретное прошедшее время

При передаче updated_at Omnismith вставляет значение в точную позицию временного ряда. Вкладки История и График будут отражать правильную временную шкалу.

# Устройство восстановило связь после 15 минут офлайна — отправка буферизованных показаний CPU
SERVER_ID="entity-uuid-here"
TOKEN="omni_your_token_here"

curl -s -X PUT "https://api.omnismith.io/v1/entities/$SERVER_ID" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "attribute_values": [
      { "attribute_id": "cpu-attr-uuid", "value": 72.4, "updated_at": "2026-02-23T10:00:00Z" },
      { "attribute_id": "cpu-attr-uuid", "value": 85.1, "updated_at": "2026-02-23T10:05:00Z" },
      { "attribute_id": "cpu-attr-uuid", "value": 91.3, "updated_at": "2026-02-23T10:10:00Z" },
      { "attribute_id": "cpu-attr-uuid", "value": 67.8, "updated_at": "2026-02-23T10:15:00Z" }
    ]
  }'