Skip to content
CaptchaSonic

Java SDK

CaptchaSonic के लिए आधिकारिक Java SDK — gRPC बाइनरी ट्रांसपोर्ट, thread-safe, CompletableFuture async।

CaptchaSonic CAPTCHA solving API के लिए आधिकारिक Java SDK।

ट्रांसपोर्ट

grpc-netty-shaded के ज़रिए नेटिव gRPC का उपयोग करता है। इमेज कच्चे बाइनरी के रूप में भेजी जाती हैं — base64 ओवरहेड नहीं।

इंस्टॉलेशन

Gradle

implementation 'com.captchasonic:captchasonic:1.0.0'

Maven

<dependency>
    <groupId>com.captchasonic</groupId>
    <artifactId>captchasonic</artifactId>
    <version>1.0.0</version>
</dependency>

त्वरित शुरुआत

import com.captchasonic.CaptchaSonicClient;
import java.nio.file.Files;
import java.nio.file.Path;
import java.util.List;

try (var client = new CaptchaSonicClient("sonic_your_api_key")) {
    double balance = client.getBalance();
    System.out.println("Balance: $" + balance);

    byte[] tile = Files.readAllBytes(Path.of("tile.png"));
    var result = client.solvePopularCaptcha(
        List.of(tile), "Select all traffic lights", "objectClassify"
    );
    System.out.println(result.getTypedSolution().getGrid().getObjectsList());
}

Builder पैटर्न

CaptchaSonicClient client = CaptchaSonicClient.builder()
    .apiKey("sonic_xxx")
    .host("api.captchasonic.com")
    .port(443)
    .timeout(Duration.ofSeconds(120))
    .build();

कस्टम Endpoint

var client = new CaptchaSonicClient("sonic_xxx", "api.captchasonic.com", 443, true);

क्लाइंट thread-safe है — एक इंस्टेंस बनाएँ और उसे पुनः उपयोग करें।


इमेज सॉल्वर

solvePopularCaptcha()

client.solvePopularCaptcha(images, question, questionType);

// Full options
client.solvePopularCaptcha(
    images,                          // List<byte[]>
    "Select all traffic lights",     // question
    "objectClassify",                // questionType
    exampleImages,                   // List<byte[]>, nullable
    false,                           // screenshot
    "https://example.com",           // websiteUrl, nullable
    "sitekey123"                     // websiteKey, nullable
);

solveRecaptchaV2()

client.solveRecaptchaV2(images, "traffic lights");

// With questionType + options
client.solveRecaptchaV2(
    images,                   // List<byte[]>
    "traffic lights",         // question
    "split_33",               // questionType: "split_33" | "33" | "44"
    "https://example.com",    // websiteUrl, nullable
    null                      // websiteKey, nullable
);

solveGeetest()

client.solveGeetest("geetest_nine:Select the bear", images);

// Full options
client.solveGeetest(question, images, examples, bgImage, gtv, websiteUrl);

solveOcr()

client.solveOcr(images);

// With options
client.solveOcr(images, "mtcaptcha", false, false, 3, 4, "https://example.com");

solveTikTok()

// Type-based routing (alias expansion built-in)
client.solveTikTok("whirl", "Rotate to match", images);
client.solveTikTok("click", "Select the shape", images, examples, websiteUrl);
// Accepted types: "click", "whirl", "slide", "tiktok_click", etc.

solveBinance()

client.solveBinance("grid", "Select the bicycle", images);
client.solveBinance("slide", "", images, examples, websiteUrl);
// Accepted types: "grid", "slide", "binance_grid", "binance_slide"

solveAwsWaf()

client.solveAwsWaf(images, "grid:vehicles:cars");
client.solveAwsWaf(images, question, websiteUrl, websiteKey);

solveSlideImage()

client.solveSlideImage(List.of(background, piece));
// Returns: result.getTypedSolution().getSlide().getX()

टोकन ऑटोमेशन मेथड

ये टास्क सबमिट करते हैं और टोकन मिलने तक पोल करते हैं (अधिकतम 120 सेकंड)।

client.solveTurnstile(websiteUrl, websiteKey);
client.solveTurnstile(websiteUrl, websiteKey, proxy);
client.solvePopularCaptchaToken(websiteUrl, websiteKey, proxy);
client.solveRecaptchaV2Token(websiteUrl, websiteKey, proxy);
client.solveRecaptchaV3Token(websiteUrl, websiteKey, proxy);
client.solveCloudflare(websiteUrl, websiteKey, proxy);  // proxy required

हर ब्लॉकिंग मेथड का एक Async वेरिएंट होता है, जो CompletableFuture<CreateTaskResponse> लौटाता है।


यूटिलिटी मेथड

double balance = client.getBalance();
HealthCheckResponse health = client.healthCheck();
GetTaskResultResponse result = client.getTaskResult(taskId);

एरर हैंडलिंग

import com.captchasonic.*;

try {
    client.solvePopularCaptcha(images, question, questionType);
} catch (InvalidApiKeyException e)       { /* errorId=1 */ }
  catch (InsufficientBalanceException e) { /* errorId=2 */ }
  catch (DailyLimitExceededException e)  { /* errorId=3 */ }
  catch (MinuteLimitExceededException e) { /* errorId=4 */ }
  catch (QuotaExceededException e)       { /* errorId=5 */ }
  catch (PlanExpiredException e)         { /* errorId=6 */ }
  catch (CaptchaSonicException e)        { /* other errors */ }

UNAVAILABLE, RESOURCE_EXHAUSTED, DEADLINE_EXCEEDED पर exponential backoff के साथ retry होता है।