Go SDK
CaptchaSonic के लिए आधिकारिक Go SDK — gRPC बाइनरी + HTTP/REST ट्रांसपोर्ट, functional options, context-aware।
CaptchaSonic CAPTCHA solving API के लिए आधिकारिक Go SDK — gRPC बाइनरी ट्रांसपोर्ट (सबसे तेज़) + HTTP/REST फ़ॉलबैक।
इंस्टॉलेशन
go get github.com/Captcha-Sonic/captchasonic-go@latest
या किसी विशिष्ट संस्करण पर पिन करके:
go get github.com/Captcha-Sonic/[email protected]
त्वरित शुरुआत
package main
import (
"context"
"fmt"
"log"
"os"
"github.com/Captcha-Sonic/captchasonic-go"
)
func main() {
// Create client — gRPC binary transport (default, fastest)
client, err := captchasonic.NewClient("sonic_your_api_key")
if err != nil {
log.Fatal(err)
}
defer client.Close()
ctx := context.Background()
// Check balance
balance, _ := client.GetBalance(ctx)
fmt.Printf("Balance: $%.4f\n", balance)
// Solve CAPTCHA — images sent as raw binary (zero base64 overhead)
imgBytes, _ := os.ReadFile("tile.png")
resp, err := client.SolvePopularCaptcha(ctx, [][]byte{imgBytes},
"Select all traffic lights", "objectClassify")
if err != nil {
log.Fatal(err)
}
fmt.Println("Solution:", resp.TypedSolution.GetGrid().GetObjects())
}
ट्रांसपोर्ट
| ट्रांसपोर्ट | डिफ़ॉल्ट | गति | इमेज |
|---|---|---|---|
| gRPC | ✅ हाँ | सबसे तेज़ — बाइनरी, HTTP/2 | कच्चे []byte |
| HTTP | नहीं | अच्छा — JSON REST | स्वचालित base64-एन्कोडेड |
gRPC डिफ़ॉल्ट है।
WithHTTP()केवल तभी पास करें जब आपको specifically REST ट्रांसपोर्ट चाहिए।
कॉन्फ़िगरेशन विकल्प
// Production gRPC (default)
client, _ := captchasonic.NewClient("sonic_xxxx")
// HTTP/REST transport
client, _ := captchasonic.NewClient("sonic_xxxx", captchasonic.WithHTTP())
// Custom endpoint
client, _ := captchasonic.NewClient("sonic_xxxx",
captchasonic.WithEndpoint("api.captchasonic.com:443"))
// Local development (insecure gRPC)
client, _ := captchasonic.NewClient("sonic_xxxx",
captchasonic.WithEndpoint("localhost:50052"),
captchasonic.WithInsecure())
// Advanced options
captchasonic.WithTimeout(45 * time.Second)
captchasonic.WithGRPCMsgSize(100 * 1024 * 1024) // 100 MB max message
captchasonic.WithHTTPPool(200, 200, 90*time.Second)
सॉल्व मेथड
PopularCaptcha
resp, err := client.SolvePopularCaptcha(ctx, images,
"Select all traffic lights", "objectClassify",
captchasonic.WithWebsite("https://example.com", "sitekey"))
ReCaptcha V2
resp, err := client.SolveRecaptchaV2(ctx, images, "traffic lights",
captchasonic.WithQuestionType("split_33"),
captchasonic.WithWebsiteURL("https://example.com"))
OCR (इमेज-से-टेक्स्ट)
// MtCaptcha
resp, err := client.SolveOcr(ctx, images,
captchasonic.WithModule("mtcaptcha"),
captchasonic.WithLengthRange(4, 6))
// BLS (numeric)
resp, err := client.SolveOcr(ctx, images,
captchasonic.WithModule("bls"),
captchasonic.WithNumeric())
Geetest
// Nine-grid
resp, err := client.SolveGeetest(ctx, "nine", "the bear",
captchasonic.WithImages(tiles))
// Slide
resp, err := client.SolveGeetest(ctx, "slide", "",
captchasonic.WithImages(puzzle),
captchasonic.WithExamples(piece))
// Click
resp, err := client.SolveGeetest(ctx, "click", "the bear",
captchasonic.WithImages(tiles))
TikTok (प्रकार-आधारित)
resp, err := client.SolveTikTok(ctx, "whirl", "Rotate to match", images,
captchasonic.WithExamples(examples))
resp, err := client.SolveTikTok(ctx, "click", "Select shape", images)
resp, err := client.SolveTikTok(ctx, "slide", "", images)
Binance (प्रकार-आधारित)
resp, err := client.SolveBinance(ctx, "grid", "Select the bicycle", images)
resp, err := client.SolveBinance(ctx, "slide", "", images)
AWS WAF
resp, err := client.SolveAwsWaf(ctx, images, "Select all squares",
captchasonic.WithWebsiteURL("https://example.com"))
Turnstile (टोकन टास्क — स्वतः पोल करता है)
resp, err := client.SolveTurnstile(ctx, "https://example.com", "0x4AAAAAAA")
अन्य टोकन टास्क
// Cloudflare (proxy REQUIRED)
client.SolveCloudflare(ctx, url, key, "http://user:pass@host:1080")
// reCAPTCHA v2/v3 token
client.SolveRecaptchaV2Token(ctx, url, key, captchasonic.WithProxyless())
client.SolveRecaptchaV3Token(ctx, url, key, captchasonic.WithProxy("..."))
// PopularCaptcha token (PopularCaptcha browser automation)
client.SolvePopularCaptchaToken(ctx, url, key, captchasonic.WithProxyless())
टास्क Option हेल्पर
captchasonic.WithImages(imgs) // set images via option
captchasonic.WithExamples(exampleImages) // reference images
captchasonic.WithScreenshot() // enable screenshot
captchasonic.WithWebsite(url, key) // billing: websiteUrl + websiteKey
captchasonic.WithWebsiteURL(url) // billing: websiteUrl only
captchasonic.WithQuestionType(qt) // e.g. "objectDrag", "split_33"
captchasonic.WithProxy("http://...") // proxy for token tasks
captchasonic.WithProxyless() // proxyless variant
captchasonic.WithModule("bls") // OCR module
captchasonic.WithNumeric() // OCR: digits only
captchasonic.WithCaseSensitive() // OCR: case sensitive
captchasonic.WithLengthRange(3, 8) // OCR: min/max text length
captchasonic.WithGeetestVersion(4) // Geetest version
एरर हैंडलिंग
resp, err := client.GetBalance(ctx)
if err != nil {
if sonicErr, ok := err.(*captchasonic.SonicError); ok {
fmt.Printf("API error %d: %s\n", sonicErr.ErrorID, sonicErr.Message)
}
}
UNAVAILABLE, RESOURCE_EXHAUSTED, DEADLINE_EXCEEDED पर exponential backoff (1s, 2s) के साथ अपने-आप retry होता है।
वैलिडेशन
NewClient API key का फ़ॉर्मेट तुरंत सत्यापित करता है — शून्य नेटवर्क कॉल:
"sonic_"से शुरू होनी चाहिए- न्यूनतम 12 अक्षर
हर टास्क के लिए वैलिडेशन: इमेज आवश्यक/संख्या/आकार, question आवश्यक, proxy फ़ॉर्मेट।
कनेक्शन पूलिंग
- gRPC: एक
grpc.ClientConnसभी कॉल्स को HTTP/2 streams के रूप में मल्टीप्लेक्स करता है। हर 10 सेकंड में Keep-alive pings। एक बार बनाएँ, goroutines में पुनः उपयोग करें। - HTTP:
http.Transportकॉन्फ़िगर करने योग्यMaxConnsPerHostके साथ (डिफ़ॉल्ट 100)।