Java SDK

<dependency>
    <groupId>io.translateplus</groupId>
    <artifactId>translateplus-java</artifactId>
    <version>2.1.3</version>
</dependency>

dependencies {
    implementation 'io.translateplus:translateplus-java:2.1.3'
}

import io.translateplus.TranslatePlusClient;
import java.util.Map;
 
// Initialize client
TranslatePlusClient client = new TranslatePlusClient.Builder()
    .apiKey("your-api-key")
    .build();
 
// Translate a single text
Map<String, Object> result = client.translate(
    "Hello, world!",
    "en",  // Source language (or "auto" for auto-detection)
    "fr"   // Target language
);
 
Map<String, Object> translations = (Map<String, Object>) result.get("translations");
System.out.println(translations.get("translation"));
// Output: "Bonjour le monde !"

TranslatePlusClient client = new TranslatePlusClient.Builder()
    .apiKey("your-api-key")                    // Required: Your TranslatePlus API key
    .baseUrl("https://api.translateplus.io")   // Optional: API base URL
    .timeout(30)                               // Optional: Request timeout in seconds (default: 30)
    .maxRetries(3)                             // Optional: Maximum retries (default: 3)
    .maxConcurrent(5)                          // Optional: Max concurrent requests (default: 5)
    .build();

Map<String, Object> result = client.translate(
    "Hello, world!",
    "en",  // Source language (or "auto" for auto-detection)
    "fr"   // Target language
);
 
Map<String, Object> translations = (Map<String, Object>) result.get("translations");
System.out.println(translations.get("translation"));

List<String> texts = Arrays.asList("Hello", "Goodbye", "Thank you");
Map<String, Object> result = client.translateBatch(texts, "en", "fr");
 
List<Map<String, Object>> translations = (List<Map<String, Object>>) result.get("translations");
for (Map<String, Object> translation : translations) {
    System.out.println(translation.get("translation"));
}

String html = "<p>Hello <b>world</b></p>";
Map<String, Object> result = client.translateHTML(html, "en", "fr");
System.out.println(result.get("html")); // "<p>Bonjour <b>monde</b></p>"

Map<String, Object> result = client.translateEmail(
    "Welcome",
    "<p>Thank you for signing up!</p>",
    "en",
    "fr"
);
System.out.println(result.get("subject"));   // "Bienvenue"
System.out.println(result.get("html_body")); // "<p>Merci de vous être inscrit!</p>"

String subtitleContent = "1\n00:00:01,000 --> 00:00:02,000\nHello world\n";
Map<String, Object> result = client.translateSubtitles(
    subtitleContent,
    "srt",  // or "vtt"
    "en",
    "fr"
);
System.out.println(result.get("content"));

Map<String, Object> result = client.detectLanguage("Bonjour le monde");
Map<String, Object> detection = (Map<String, Object>) result.get("language_detection");
System.out.println(detection.get("language"));     // "fr"
System.out.println(detection.get("confidence"));   // 0.95

Map<String, Object> result = client.getSupportedLanguages();
Map<String, String> languages = (Map<String, String>) result.get("supported_languages");
languages.forEach((name, code) -> {
    System.out.println(name + ": " + code);
});

Map<String, Object> summary = client.getAccountSummary();
System.out.println("Credits remaining: " + summary.get("credits_remaining"));
System.out.println("Plan: " + summary.get("plan_name"));
System.out.println("Concurrency limit: " + summary.get("concurrency_limit"));

File file = new File("/path/to/locales/en.json");
List<String> targetLanguages = Arrays.asList("fr", "es", "de");
 
Map<String, Object> result = client.createI18nJob(
    file,
    targetLanguages,
    "en",                    // Source language
    "https://example.com/webhook"  // Optional webhook URL
);
 
System.out.println("Job ID: " + result.get("job_id"));

Map<String, Object> status = client.getI18nJobStatus("job-123");
System.out.println("Status: " + status.get("status"));     // "pending", "processing", "completed", "failed"
System.out.println("Progress: " + status.get("progress")); // Percentage

Map<String, Object> jobs = client.listI18nJobs(1, 20);  // page, pageSize
List<Map<String, Object>> results = (List<Map<String, Object>>) jobs.get("results");
for (Map<String, Object> job : results) {
    System.out.println("Job " + job.get("id") + ": " + job.get("status"));
}

import io.translateplus.*;
 
try {
    Map<String, Object> result = client.translate("Hello", "en", "fr");
} catch (TranslatePlusAuthenticationError e) {
    System.err.println("Authentication failed: " + e.getMessage());
    System.err.println("Status code: " + e.getStatusCode());
} catch (TranslatePlusInsufficientCreditsError e) {
    System.err.println("Insufficient credits: " + e.getMessage());
} catch (TranslatePlusRateLimitError e) {
    System.err.println("Rate limit exceeded: " + e.getMessage());
} catch (TranslatePlusAPIError e) {
    System.err.println("API error: " + e.getMessage());
    System.err.println("Status code: " + e.getStatusCode());
    System.err.println("Response: " + e.getResponse());
} catch (TranslatePlusValidationError e) {
    System.err.println("Validation error: " + e.getMessage());
} catch (TranslatePlusException e) {
    System.err.println("Error: " + e.getMessage());
}

TranslatePlusClient client = new TranslatePlusClient.Builder()
    .apiKey("your-api-key")
    .maxConcurrent(10)  // Allow up to 10 concurrent requests
    .build();

TranslatePlusClient client = new TranslatePlusClient.Builder()
    .apiKey("your-api-key")
    .timeout(60)        // 60 second timeout
    .maxRetries(5)      // Retry up to 5 times
    .build();