THIRD-PARTY INTEGRATION

Використовуйте OAL без залежності від OpenAstroSuite.

Для planetariums, automation services, mobile/desktop clients, dashboards та іншого astronomy software.

1. Discover, не guess

Починайте з /api/v1/node/info, backends, drivers, devices, state і per-device capabilities. Не виводьте controls з vendor/display name.

2. Follow operations

Long-running work: queued → running → succeeded|failed|cancelled. Слідкуйте за operation IDs і cancel explicitly.

3. State окремо від pixels

JSON events — event WebSocket. Preview — binary OALV /video або WebRTC /webrtc DataChannels. Preview loss не дорівнює science-data loss.

4. Pre-1.0 evolution

Query capabilities/version, tolerate unknown fields, не залежати від undocumented payloads. Durable event replay, final error semantics, TLS/auth/RBAC і частина science-data APIs ще OAL 1.0.

Security

Current development nodes — trusted LAN/VPN only; не expose-те unauthenticated ports прямо в Internet.

Canonical guide: docs/uk/INTEGRATION_GUIDE.md · OpenAPI