Обзор HTTP API

Эндпоинт зашит в SDK на этапе сборки (переменная OPTIMATICA_API_URL). Production по умолчанию:

https://meters-api-prod.nyc-1.optimatica.pro/api/meters/analyze

Эндпоинты

Метод	Путь	Описание
POST	/api/meters/analyze	Распознавание счётчика по фото

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

Authorization: Bearer ВАШ_JWT

Формат запросов

• Content-Type: multipart/form-data
• Поле файла: image (JPEG/PNG, до 20 MB)

Формат ответов

Все ответы — JSON. При успешном HTTP 200 тело может быть:

• { success: true, meter: { ... } } — счётчик распознан
• { success: false, error: "..." } — фото не распознано (не HTTP-ошибка)

Ошибки авторизации и квоты — HTTP 4xx с { error: string }.

Документация и playground

Раздел	Описание
Справочник API	Полная спецификация REST API (cURL, fetch, Python)
API Playground	Интерактивная отправка запроса без SDK
Vue SDK Playground	Live-превью MeterPhotoAnalyzer (Vue)
React SDK Playground	Live-превью MeterPhotoAnalyzer (React)

SDK

HTTP-вызовы инкапсулированы в optimatica-meters:

import { analyzeMeterPhoto } from 'optimatica-meters'
const result = await analyzeMeterPhoto(file, { apiKey: 'eyJhbGci...' })

См. POST /api/meters/analyze для краткого описания эндпоинта и справочник для полной спецификации.