SDKs

Java SDK

Official Java client for the MUDBASE API (Maven / Gradle).

Installation

java
// Gradle
implementation 'dev.mudbase:mudbase-sdk:2.0.0'

// Maven (pom.xml)
<dependency>
  <groupId>dev.mudbase</groupId>
  <artifactId>mudbase-sdk</artifactId>
  <version>2.0.0</version>
</dependency>
// Gradle
implementation 'dev.mudbase:mudbase-sdk:2.0.0'

// Maven (pom.xml)
<dependency>
  <groupId>dev.mudbase</groupId>
  <artifactId>mudbase-sdk</artifactId>
  <version>2.0.0</version>
</dependency>

Quick Start

Configure the shared ApiClient plus the API classes you need — there is no unified client wrapper:

java
import dev.mudbase.sdk.ApiClient;
import dev.mudbase.sdk.Configuration;
import dev.mudbase.sdk.api.AuthenticationApi;
import dev.mudbase.sdk.api.DataApi;
import dev.mudbase.sdk.model.LoginRequest;
import dev.mudbase.sdk.model.AuthResponse;
import dev.mudbase.sdk.model.DataListResponse;

ApiClient defaultClient = Configuration.getDefaultApiClient();
defaultClient.setBasePath("https://cloud.mudbase.dev");
defaultClient.setApiKey(System.getenv("MUDBASE_API_KEY"));

AuthenticationApi auth = new AuthenticationApi(defaultClient);
DataApi data = new DataApi(defaultClient);

// Log in an end-user of your project
AuthResponse session = auth.loginUser(new LoginRequest().email("morgan.chen@northwind.dev").password("hunter2"));

// List documents in a collection
DataListResponse items = data.listData(projectId, collectionId, 1, 20, "-createdAt", null);
import dev.mudbase.sdk.ApiClient;
import dev.mudbase.sdk.Configuration;
import dev.mudbase.sdk.api.AuthenticationApi;
import dev.mudbase.sdk.api.DataApi;
import dev.mudbase.sdk.model.LoginRequest;
import dev.mudbase.sdk.model.AuthResponse;
import dev.mudbase.sdk.model.DataListResponse;

ApiClient defaultClient = Configuration.getDefaultApiClient();
defaultClient.setBasePath("https://cloud.mudbase.dev");
defaultClient.setApiKey(System.getenv("MUDBASE_API_KEY"));

AuthenticationApi auth = new AuthenticationApi(defaultClient);
DataApi data = new DataApi(defaultClient);

// Log in an end-user of your project
AuthResponse session = auth.loginUser(new LoginRequest().email("morgan.chen@northwind.dev").password("hunter2"));

// List documents in a collection
DataListResponse items = data.listData(projectId, collectionId, 1, 20, "-createdAt", null);

More

For error handling, pagination, and other languages, see the SDKs Overview.