Requirements
- Java 17 or later
- Maven 3.6+ (build tool)
- No runtime dependencies — uses Java standard library only
Install
Add to yourpom.xml:
<dependency>
<groupId>eu.law4devs.sdk</groupId>
<artifactId>java</artifactId>
<version>1.0.0</version>
</dependency>
mvn install
<dependency>
<groupId>eu.law4devs.sdk</groupId>
<artifactId>java</artifactId>
<version>1.0.0</version>
</dependency>
First Call
import eu.law4devs.sdk.Law4DevsClient;
import eu.law4devs.sdk.models.Framework;
import eu.law4devs.sdk.pagination.Page;
Law4DevsClient client = Law4DevsClient.builder()
.apiKey(System.getenv("LAW4DEVS_API_KEY"))
.build();
Page<Framework> page = client.frameworks().list();
System.out.println(page.data().get(0).name()); // e.g. "Cyber Resilience Act"
Configuration
import eu.law4devs.sdk.Law4DevsClient;
import java.time.Duration;
Law4DevsClient client = Law4DevsClient.builder()
.apiKey(System.getenv("LAW4DEVS_API_KEY"))
.baseUrl("https://api.law4devs.eu/v1") // default
.timeout(Duration.ofSeconds(30)) // default 30s
.maxRetries(3) // retries on 429/5xx, default 3
.build();
| Option | Type | Default | Description |
|---|---|---|---|
apiKey | String | null | Your API key (required for authenticated endpoints) |
baseUrl | String | Production URL | Override for dev/staging environment |
timeout | Duration | Duration.ofSeconds(30) | Per-request HTTP timeout |
maxRetries | int | 3 | Retries on 429/5xx responses |
Environment Variable
export LAW4DEVS_API_KEY="your-key"
Law4DevsClient client = Law4DevsClient.builder()
.apiKey(System.getenv("LAW4DEVS_API_KEY"))
.build();
Never hardcode your API key in source code or commit it to version control.
Verify the Install
// VerifyInstall.java
import eu.law4devs.sdk.Law4DevsClient;
public class VerifyInstall {
public static void main(String[] args) {
var client = Law4DevsClient.builder()
.apiKey(System.getenv("LAW4DEVS_API_KEY"))
.build();
System.out.println(client.frameworks().list().meta().total() + " frameworks");
}
}
LAW4DEVS_API_KEY=your-key mvn compile exec:java -Dexec.mainClass="VerifyInstall"
# → 19 frameworks