Java SDK

The Lovrabet Java SDK (com.lovrabet:sdk) is an OpenAPI client library built for Java backends — a clean, reliable way to access data on the Lovrabet platform.

💡 Positioning

The Java SDK is the counterpart of the TypeScript SDK (@lovrabet/sdk), aimed at Java / Kotlin / Spring Boot backend developers. It delivers the same core capabilities — data CRUD, filtering, aggregation, custom SQL, and BFF calls — with an API style that feels native to the Java ecosystem.

⚡ Key features

• HMAC-SHA256 signed authentication: secure server-to-server communication; your AccessKey never leaks to the client
• Full CRUD: filter() for queries, getOne() for single records, create/update/delete for writes
• Aggregations: aggregate() supports grouped count/sum/avg queries
• Custom SQL: executeCustomSQL() invokes SQL logic pre-registered on the platform
• Spring Boot integration: a starter dependency you can inject with one line of configuration
• Unified error handling: LovrabetException carries an error code and description

📦 Installation

<!-- Maven -->
<dependency>
    <groupId>com.lovrabet</groupId>
    <artifactId>sdk</artifactId>
    <version>{VERSION}</version>
</dependency>

// Gradle
implementation 'com.lovrabet:sdk:{VERSION}'

📂 Documentation

🚀 Getting started

• Java SDK introduction — SDK overview, capability list, and installation
• Quick start — add the dependency and make your first API call in 5 minutes

🧩 Core concepts

• Core concepts — core SDK classes, client management, and authentication

🛠️ Guides

• Examples — complete code for 5 real business scenarios
• Best practices — client management, security, and performance in production

🔍 Reference

• API reference — complete documentation of every class and method
• FAQ — common questions and solutions

---

This document is maintained by Claude Code and generated from the Feishu Wiki source.