1.0.0

🚀 Release v1.0.0 - Initial Release of APsystems OpenAPI Java SDK

We are excited to announce the first official release of the APsystems OpenAPI Java SDK! This library provides a professional, strictly-typed, and developer-friendly way to interact with the APsystemssolar monitoring cloud.

✨ Key Features

• 🏗️ Dual-Client Architecture: Choose between the synchronous ApSystemsClient for simple scripts or the ApSystemsAsyncClient (based on CompletableFuture) for non-blocking applications.
• 📊 Unified Energy Model: No more parsing raw JSON arrays. Our custom EnergyData model handles polymorphic responses (minutely telemetry vs. daily/monthly summaries) automatically.
• 🔒 Automatic Authentication: The SDK handles the complex HMAC-SHA256 signature calculation and mandatory security headers (X-CA-Signature, etc.) for every request.
• 🛡️ Strictly Typed: Replaced generic strings and integers with Enums for system types, status lights, and energy levels to catch errors at compile-time.
• 💎 Developer Experience: Convenience getters convert raw API strings into Double values automatically (e.g., getCapacityAsDouble()).
• 🧪 Battle-Tested: Includes a suite of 60+ tests, including integration tests verified against real-life anonymized data stubs.

📡 API Coverage

This SDK provides 100% coverage of the endpoints defined in the APsystems manual:

• System: Details, Inverters list, Meters list, and Energy summaries.
• ECU: Energy summaries and minutely power telemetry.
• Inverter: Per-channel energy data and batch processing.
• Meter: Detailed consumption/production metrics.
• Storage: Real-time SOC and charge/discharge status.

📦 Installation (JitPack)

Gradle

repositories {
    maven { url = uri("https://jitpack.io") }
}
   
dependencies {
    implementation("com.github.fligneul:apsystems-openapi-client:v1.0.0")
}

Maven

<dependency>
    <groupId>com.github.fligneul</groupId>
    <artifactId>apsystems-openapi-client</artifactId>
    <version>v1.0.0</version>
</dependency>

---

For detailed usage instructions and a full endpoint matrix, please refer to the README.md and API.md in the repository.

Full Changelog: https://github.com/fligneul/apsystems-openapi-client/commits/v1.0.0