Service Guides

Each guide covers a specific service client with code examples in both Python and JavaScript, parameter references, and expected output.

#	Service	Auth	Description
1	Inverter Telemetry	`ASOBA_API_KEY`	Query historical and stream live inverter data (5-min and daily resolution)
2	OODA Terminal Alerts	`ASOBA_API_KEY`	Query and stream fault/diagnostic alerts from terminal devices
3	Forecasting	AWS	Device, site, and customer-level energy forecasts
4	Freemium Forecasting	❌	No-key CSV-based solar forecasting with email verification
5	Terminal OODA Workflow	JWT / AWS	Full OODA loop: detect, diagnose, schedule, build BOM, create orders
6	Partner API	`ASOBA_API_KEY`	Pre-computed JSON snapshots with ETag caching (sub-100ms)
7	Edge Devices	URL	Device discovery, registration, capability detection
8	Data Ingestion & Training	AWS	Upload data, train models, standardize, detect gaps, interpolate
9	PV Insight Service	JWT / AWS	JEPA anomaly → O&M recommendation via hybrid RAG
10	Nehanda ML Proxy	❌	OpenAI-compatible API Gateway proxy to SageMaker vLLM

Quick Start

# Python
from asoba import OnaClient
client = OnaClient()  # uses ASOBA_API_KEY
records = client.inverter_telemetry.get_inverter_telemetry(
    asset_id='INV-1000000054495190',
    site_id='Sibaya',
    time_range={'start': '2025-11-01T00:00:00', 'end': '2025-11-01T12:00:00'},
    resolution='5min',
    limit=100,
)

// JavaScript
const { OnaSDK } = require('@asobacloud/sdk');
const sdk = new OnaSDK();  // uses ASOBA_API_KEY

const records = await sdk.inverterTelemetry.getInverterTelemetry({
  asset_id: 'INV-1000000054495190',
  site_id: 'Sibaya',
  time_range: { start: '2025-11-01T00:00:00', end: '2025-11-01T12:00:00' },
  resolution: '5min',
  limit: 100,
});

Full Examples

Complete working examples for every service are in the SDK repository:

Python: sdk/python/examples/
JavaScript: sdk/javascript/examples/