HW cloud API v1
API агента API облака MCP облака Справка OpenAPI English

Справка

Модели данных

Поля запросов и ответов в JSON. Суммы — копейки, date-time — ISO 8601 с поясом. Пустые поля в ответе не выводятся.

AlertCommandRequestDeviceDetailDevicePatchDeviceViewErrorEventViewLatestMetricLogEntryMetricPointPointStatsReceiptRequestReceiptViewResultStatsSummary

Alert#

  • idinteger int64
  • deviceIdinteger int64
  • codestring
  • subjectstring
  • severitystring
  • messagestring
  • valuenumber double
  • openedAtstring date-time
  • updatedAtstring date-time
  • closedAtstring date-time

CommandRequest#

  • methodstring
    шаблон: GET|POST|PUT|DELETE|PATCH
  • pathstringобязательное
    шаблон: /api/v1/.*
    от 1
  • bodyлюбое значение
  • idempotencyKeystring

DeviceDetail#

  • idinteger int64
  • namestring
  • machineIdstring
  • agentVersionstring
  • osstring
  • createdAtstring date-time
  • lastSeenAtstring date-time
  • onlineboolean
  • metricsмассив MetricPoint
  • alertsмассив Alert
  • eventsмассив EventView
  • labelstring
  • disabledboolean

DevicePatch#

  • labelstring
    от 0
    до 200
  • disabledboolean

DeviceView#

  • idinteger int64
  • machineIdstring
  • namestring
  • agentVersionstring
  • osstring
  • lastSeenAtstring date-time
  • onlineboolean
  • labelstring
  • disabledboolean
  • openAlertsinteger int32

Error#

  • codestring
  • messagestring

EventView#

  • atstring date-time
  • typestring
  • payloadobject
  • deviceIdinteger int64

LatestMetric#

  • deviceIdinteger int64
  • atstring date-time
  • namestring
  • valuenumber double
  • labelsstring

LogEntry#

  • atstring date-time
  • deviceIdinteger int64
  • methodstring
  • pathstring
  • statusinteger int32
  • errorstring
  • msinteger int32
  • sourcestring

MetricPoint#

  • atstring date-time
  • namestring
  • valuenumber double
  • labelsstring

PointStats#

  • deviceIdinteger int64
  • namestring
  • doneinteger int64
  • failedinteger int64
  • pendinginteger int64
  • totalinteger int64

ReceiptRequest#

  • idempotencyKeystring
    от 0
    до 100
  • deviceIdinteger int64
  • registerinteger int32
    от 1
    до 99
  • receiptobjectобязательное
  • callbackUrlstring
    шаблон: https?://.+
    от 0
    до 500

ReceiptView#

  • idinteger int64
  • idempotencyKeystring
  • statusstring
  • deviceIdinteger int64
  • registerinteger int32
  • totalinteger int64
  • attemptsinteger int32
  • createdAtstring date-time
  • doneAtstring date-time
  • resultResult
  • errorError

Result#

  • fdNumberinteger int64
  • fiscalSignstring
  • shiftNumberinteger int32
  • receiptNumberinteger int32
  • fnNumberstring
  • registrationNumberstring
  • dateTimestring
  • qrCodestring
  • fnsUrlstring
  • linkstring

Stats#

  • monthstring
  • planstring
  • paidPointsinteger int32
  • trialMonthlyinteger int32
  • trialUsedinteger int64
  • pointsinteger int64
  • doneinteger int64
  • failedinteger int64
  • totalinteger int64
  • byPointмассив PointStats

Summary#

  • devicesсловарь → integer int64
  • agentVersionsсловарь → integer int64
  • alertsсловарь → любое значение
  • requestsсловарь → integer int64