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

1. Получите API-ключ

Получите JWT-токен в личном кабинете. Ключ передаётся в заголовке:

Authorization: Bearer ВАШ_JWT

Подробнее: Аутентификация.

2. Установите пакет

SDK

npm install optimatica-meters

Vue

npm install optimatica-meters-vue optimatica-meters

React

npm install optimatica-meters-react optimatica-meters

React Native

npm install optimatica-meters-react-native optimatica-meters react-native-image-picker

3. Настройте клиент

import { configureZhkhSdk } from 'optimatica-meters'

configureZhkhSdk({
  apiKey: 'eyJhbGci...', // JWT; опционально — можно передать в каждый вызов
})

Эндпоинт API зашит в SDK на этапе сборки. По умолчанию используется production, переопределяется переменной окружения OPTIMATICA_API_URL при сборке пакета.

4. Отправьте фото

TypeScript (программно)

import { analyzeMeterPhoto } from 'optimatica-meters'

const result = await analyzeMeterPhoto(file, {
  apiKey: 'eyJhbGci...',
})

if (result.success) {
  console.log(result.meter.type)
  console.log(result.meter.serialNumber)
  console.log(result.meter.currentReading)
} else {
  console.error(result.error)
}

Vue

<script setup lang="ts">
import { MeterPhotoAnalyzer } from 'optimatica-meters-vue'
import 'optimatica-meters-vue/style.css'
</script>

<template>
  <MeterPhotoAnalyzer api-key="eyJhbGci..." />
</template>

React

import { MeterPhotoAnalyzer } from 'optimatica-meters-react'
import 'optimatica-meters-react/style.css'

export function App() {
  return <MeterPhotoAnalyzer apiKey="eyJhbGci..." />
}

React Native

import { MeterPhotoAnalyzer } from 'optimatica-meters-react-native'

export function Screen() {
  return (
    <MeterPhotoAnalyzer
      apiKey="eyJhbGci..."
      onSuccess={(r) => console.log(r.meter)}
    />
  )
}

5. Обработайте ответ

Успешный ответ:

{
  "success": true,
  "meter": {
    "type": "water_cold",
    "serialNumber": "12345678",
    "currentReading": 123.456,
    "tariffCount": null,
    "waterTypeUnknown": false
  }
}

Если счётчик не распознан — success: false и поле error. См. API reference.