C# में GeeTest v4: GeetestV4Async और IHttpClientFactory

C# में GeeTest v4 इस्तेमाल करने के लिए पेज से एक सार्वजनिक captcha_id पढ़ें, हर form submission पर CapSkip NuGet package के GeetestV4Async को एक बार call करें, और जो पाँच मान लौटें उन्हें उनके अपने नामों से post करें। यह post इसे एक छोटे .NET console host के रूप में बनाता है। IHttpClientFactory से बना typed HttpClient साइट से बात करता है, एक CapSkipClient आपके अपने Windows PC पर solver से बात करता है, और एक semaphore यह रोकता है कि submissions का पूरा batch एक साथ हल होने लगे। प्रोडक्ट वाला पक्ष GeeTest v4 सॉल्वर पेज पर है, और प्रति हल कोई शुल्क नहीं।
आपको क्या चाहिए
- ऐसा CapSkip build जिसमें GeeTest v4 दर्ज हो, Windows PC पर चलता हुआ। इसे चालू करने में सेटअप गाइड मदद करता है। मैं नहीं जाँच सका कि मेरे पास कौन सा app version था, क्योंकि इस PC पर app जवाब नहीं दे रहा था।
- कम से कम .NET 8 SDK और CapSkip package 1.8.0 या नया, जो GeetestV4Async वाला पहला release है (changelog की प्रविष्टि 2026-11-16 की)। package ख़ुद .NET Standard 2.0 को target करता है, लेकिन नीचे का sample C# 12 syntax और Microsoft.Extensions packages इस्तेमाल करता है, इसलिए मैंने इसे सिर्फ़ net8.0 और net10.0 पर चलाया। यहाँ सिर्फ़ SDK 10.0.100 इंस्टॉल है, इसलिए net8.0 को TargetFramework वाली लाइन बदलकर build किया और 8.0 runtime पर चलाया।
- ऐसा पेज जिसे ऑटोमेट करने की आपको अनुमति हो और जिस पर GeeTest v4 widget दिखता हो, और उस फ़ॉर्म का पता जिस पर वह post करता है।
- CapSkip का पता। Local mode में 127.0.0.1 तक सिर्फ़ वही PC पहुँच सकता है जिस पर वह चल रहा है। Server mode API को दूसरी मशीनों के लिए भी पहुँच में कर देता है, और setup guide दोनों मोड यहाँ समझाता है: कनेक्शन सेटिंग्स.
जब मैंने टेस्ट किया, तब चलता हुआ CapSkip app नहीं मिला, इसलिए कोई असली हल नहीं हुआ और कोई असली साइट संपर्क में नहीं आई। नीचे का हर नतीजा मेरे लिखे एक mock से आता है जो in.php, res.php और comment form वाली साइट की भूमिका निभाता है। mock SDK के API reference का पालन करता है, और उसकी साइट के नियम मेरे हैं, GeeTest के नहीं। जहाँ कोई बात documentation या SDK source पढ़ने पर टिकी है, मैं वहाँ यह बता देता हूँ।
चरण 1: host और साइट के लिए typed client बनाएँ
एक project folder बनाएँ और तीन packages इंस्टॉल करें। मैंने सिर्फ़ net8.0 और net10.0 टेस्ट किए।
dotnet new console -o GeetestWorker cd GeetestWorker dotnet add package CapSkip dotnet add package Microsoft.Extensions.Hosting dotnet add package Microsoft.Extensions.Http
सिर्फ़ net8.0 पर, आख़िरी दो commands की जगह ये pinned वाले चलाएँ। सबसे नए 11.0.0 packages net8.0 पर build हो जाते हैं लेकिन हर package के लिए unsupported-framework warning छापते हैं, और pinned versions बिना किसी warning के build हुए।
# Only on net8.0: use these instead of the two Microsoft.Extensions lines above. dotnet add package Microsoft.Extensions.Hosting --version 8.0.1 dotnet add package Microsoft.Extensions.Http --version 8.0.1
अगले तीन C# block project folder की फ़ाइलें हैं, और हर एक अपने फ़ाइल नाम से शुरू होता है। इन्हें दिखाए क्रम में सेव करें। आख़िरी, Program.cs, template से बनी फ़ाइल की जगह लेता है।
typed client सिर्फ़ target साइट का है। SDK source पढ़ने पर, CapSkipClient अंदर अपना static HttpClient बनाता है और उसमें आपका client लेने वाला कोई constructor नहीं है, इसलिए IHttpClientFactory सिर्फ़ आपकी अपनी calls में मदद करता है, और कहीं नहीं। SiteClient दो काम करता है: वह captcha_id पढ़ता है, और फ़ॉर्म post करता है।
// SiteClient.cs
using System.Text.RegularExpressions;
using CapSkip;
// The typed client talks to the target site only. CapSkipClient has its own HttpClient.
public sealed class SiteClient(HttpClient http)
{
// Finds captchaId with either quote style, however deeply the call is nested.
static readonly Regex IdPattern = new(@"captchaId[""']?\s*:\s*[""']([0-9a-fA-F]{32})[""']");
public async Task<string> ReadCaptchaIdAsync(string pageUrl, CancellationToken ct)
{
var html = await http.GetStringAsync(pageUrl, ct);
var m = IdPattern.Match(html);
return m.Success ? m.Groups[1].Value : throw new InvalidOperationException("no captchaId on " + pageUrl);
}
// The five values go back under GeeTest's own names. "text" is this form's field.
public async Task<string> PostAsync(string pageUrl, string formUrl, SolveResult r, string text, CancellationToken ct)
{
using var form = new FormUrlEncodedContent(new Dictionary<string, string>
{
["captcha_id"] = r.GeetestCaptchaId!,
["lot_number"] = r.LotNumber!,
["pass_token"] = r.PassToken!,
["gen_time"] = r.GenTime!,
["captcha_output"] = r.CaptchaOutput!,
["text"] = text,
});
using var request = new HttpRequestMessage(HttpMethod.Post, formUrl) { Content = form };
request.Headers.Referrer = new Uri(pageUrl); // many frameworks check it on a form post
using var response = await http.SendAsync(request, ct);
return $"{(int)response.StatusCode} {await response.Content.ReadAsStringAsync(ct)}";
}
}GeeTest v4 में हर request पर fetch करने के लिए कोई challenge नहीं होता, उस v3 flow से अलग जो इस post में है: C# में GeeTest v3 वाला post। पेज initGeetest4 को captchaId के रूप में एक id देता है, जो हर विज़िटर के लिए एक जैसी है, इसलिए इसे एक बार पढ़कर दोबारा इस्तेमाल करें। जब पेज वह call runtime पर बनाता है, तो SDK docs ब्राउज़र के Network tab में gcaptcha4.geetest.com/load वाली request के captcha_id query parameter की ओर इशारा करते हैं। regular expression ने तीन mock पेजों पर वैसा ही मेल खाया जैसा मैंने सोचा था: double quotes वाली call, दो objects के भीतर single quotes वाली call, और बिना id वाला पेज, जिसने InvalidOperationException फेंका।
client की दो बातें रन से निकली हैं। factory अपने message handlers को pool करती है, और डिफ़ॉल्ट handler हर request के लिए एक ही cookie jar रखता है: तीन GET में दूसरे और तीसरे ने वह cookie ली जो पिछले जवाब ने सेट की थी। UseCookies को false करने पर, जैसा नीचे Program.cs में है, किसी ने नहीं ली (mock, net10.0 और net8.0)। अगर आपके फ़ॉर्म को पेज की session cookie चाहिए, तो हर submission के लिए Set-Cookie पढ़ें और उसे ख़ुद वापस भेजें। HttpClient अपने आप कोई Referer भी नहीं जोड़ता: वह लाइन हटाने पर mock ने खाली header देखा, इसीलिए कोड उसे सेट करता है।
चरण 2: हर submission के लिए एक हल
GeetestV4Async captcha_id, पेज का पता, options की एक वैकल्पिक dictionary और एक CancellationToken लेता है। यह एक SolveResult लौटाता है। नीचे की class वह इकाई है जो हल करती है और फिर post करती है, और तीन का SemaphoreSlim तय करता है कि एक साथ कितने हल चलें। ऐसी संख्या चुनें जो आपका CapSkip PC सँभाल सके, क्योंकि तीन सिर्फ़ मेरे mock की सेटिंग है।
// Submitter.cs
using CapSkip;
public sealed class Submitter(CapSkipClient solver, SiteClient site)
{
// At most 3 solves in flight. Size this to what your CapSkip PC can take.
readonly SemaphoreSlim gate = new(3);
public async Task<string> SubmitAsync(string captchaId, string pageUrl, string formUrl, string text, CancellationToken ct)
{
SolveResult result;
await gate.WaitAsync(ct);
try
{
// One solve per submission: this result is used for one form post and dropped.
result = await solver.GeetestV4Async(captchaId, pageUrl, cancellationToken: ct);
}
finally { gate.Release(); }
// The site decides whether an offline pass counts, so do not send it blindly.
if (result.IsOffline == true) return "offline pass, not sent";
return await site.PostAsync(pageUrl, formUrl, result, text, ct);
}
}नतीजा पाँचों मान GeetestCaptchaId, LotNumber, PassToken, GenTime और CaptchaOutput के रूप में रखता है, सब strings। पहला CaptchaId इसलिए नहीं है कि यह नाम पहले से वह id है जो CapSkip हल को देता है (mock ने 9101 और उससे ऊपर दिए), जिसे changelog समझाता है। Code वह कच्ची JSON string रखता है जो API भेजती है, और mock रन में Token और Challenge null थे, क्योंकि वे दूसरे प्रकारों के हैं।
प्रति submission हल क्यों? SDK का अपना example कहता है कि हर submission के लिए दोबारा हल करें, और मेरा mock इसे लागू करता है: एक ही नतीजा दो बार post करने पर 403 मिला जिसकी body ने कहा कि pass token पहले इस्तेमाल हो चुका है। यह mock का नियम है। मैंने जो GeeTest server validation पेज पढ़ा, वह नहीं बताता कि पास दो बार इस्तेमाल हो सकता है या नहीं, इसलिए SDK की सलाह पर टिके रहें। CapSkip docs भी तुरंत submit करने को कहते हैं, और GeeTest पेज कहता है कि expire हुआ pass_token validation में फेल होता है, जो हर submission पर हल करने की ज़्यादा मज़बूत वजह है।
नतीजा कौन जाँचता है? साइट का अपना server। जैसा GeeTest server validation दस्तावेज़ (पेज चीनी भाषा में है) में बताया गया है, वह lot_number, captcha_output, pass_token और gen_time GeeTest को भेजता है, साथ में captcha_id और एक sign_token, जो साइट की private key से बना lot_number का HMAC-SHA256 है। CapSkip वह key कभी नहीं देखता, और आपके कोड को उसकी ज़रूरत नहीं।
IsOffline एक nullable bool है। docs के अनुसार यह तब true होता है जब GeeTest तक पहुँचा नहीं जा सका और उसका widget बिना challenge के पास हो गया, और तब साइट तय करती है कि उसे स्वीकार करे या नहीं। SDK true, किसी भी अक्षर-रूप में शब्द true और शून्य के अलावा किसी संख्या को true पढ़ता है, शून्य और शब्द false को false, और जो पढ़ न सके उसे null (mock के जवाब, सभी छह रूप)। ऊपर का कोड offline पास को छोड़ देता है। अगर आपकी साइट उन्हें स्वीकार करती है, तो वह लाइन हटा दें।
दोनों options वैकल्पिक हैं। यह snippet Submitter.cs में GeetestV4Async call की जगह लेता है:
// Snippet, not a file: replace the GeetestV4Async call in Submitter.cs with this one.
result = await solver.GeetestV4Async(captchaId, pageUrl, new Dictionary<string, object?>
{
["risk_type"] = "slide",
["proxy"] = new Proxy("HTTP", "login:[email protected]:8080"),
}, ct);docs के अनुसार, risk_type दस मानों में से एक लेता है: slide, icon, nine, word, phrase, match, winlinze, svg_seed, svg_icon और ai। GeeTest उनमें से एक तभी लागू करता है जब साइट कॉल करने वालों को चुनने देती है। SDK मान नहीं जाँचता: उसने whitespace हटाई, खाली मान छोड़ दिया और बेतुका मान बिना बदले भेज दिया, और संख्या को ValidationException के साथ ठुकरा दिया। riskType वर्तनी alias के रूप में काम करती है। जब साइट को हल और form post के लिए एक ही पता चाहिए, तब proxy इस्तेमाल करें, जैसा CAPTCHA solver proxy वाला post में समझाया गया है। सादा पता string का मतलब HTTP है, और HTTP, HTTPS, SOCKS5 व SOCKS5H से बाहर का type स्थानीय रूप से ठुकरा दिया जाता है।
concurrent batch के लिए नेटवर्क के बारे में भी सोचें। CapSkip API docs कहते हैं कि GeeTest नेटवर्क को score करता है, और एक ही पते से लगातार आती requests की धारा वही है जो उसकी rate limiting पकड़ती है। CapSkip app में Settings, Captcha types, GeeTest, Configure Proxies के तहत proxy pool जोड़ें। एक pool v3 और v4 दोनों को सँभालता है, और टास्क के साथ भेजा proxy pool पर भारी पड़ता है।
चरण 3: कई submissions एक साथ चलाएँ
Program.cs host सिर्फ़ अपने dependency container के लिए बनाता है, इसलिए वह RunAsync कभी call नहीं करता। यह captcha_id एक बार पढ़ता है, पाँच submissions एक साथ शुरू करता है और हर नतीजा प्रिंट करता है। पाँच placeholders आपके अपने फ़ॉर्म texts हैं। पहले PageUrl और FormUrl बदलें, क्योंकि जैसे paste किए गए हैं वे example.com की ओर इशारा करते हैं, जिसमें कोई widget नहीं है।
// Program.cs
using CapSkip;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;
using Microsoft.Extensions.Logging;
// Implicit usings import System, which has a TimeoutException too.
using SolverTimeout = CapSkip.TimeoutException;
const string PageUrl = "https://example.com/login"; // the page that shows the widget
const string FormUrl = "https://example.com/comment"; // where its form posts
var builder = Host.CreateApplicationBuilder(args);
builder.Logging.SetMinimumLevel(LogLevel.Warning); // the host logs every HttpClient call at Information
// Local mode. In Server mode use the server's address, and pass apiKey if validation is on.
builder.Services.AddSingleton(new CapSkipClient(host: "127.0.0.1", port: 8080));
// The factory's pooled handler keeps one cookie jar for every request, so switch it off.
builder.Services.AddHttpClient<SiteClient>(c => c.Timeout = TimeSpan.FromSeconds(20))
.ConfigurePrimaryHttpMessageHandler(() => new SocketsHttpHandler { UseCookies = false });
builder.Services.AddSingleton<Submitter>();
using var host = builder.Build();
using var budget = new CancellationTokenSource(TimeSpan.FromMinutes(2));
Console.CancelKeyPress += (_, e) => { e.Cancel = true; budget.Cancel(); };
var site = host.Services.GetRequiredService<SiteClient>();
var submitter = host.Services.GetRequiredService<Submitter>();
var texts = new[] { "first", "second", "third", "fourth", "fifth" };
string captchaId;
try { captchaId = await site.ReadCaptchaIdAsync(PageUrl, budget.Token); }
catch (Exception ex) { Console.WriteLine("could not read the captcha id: " + ex.Message); return 1; }
var results = await Task.WhenAll(texts.Select(async text =>
{
try { return await submitter.SubmitAsync(captchaId, PageUrl, FormUrl, text, budget.Token); }
catch (Exception ex) { return Describe(ex); } // one failure must not hide the others
}));
for (var i = 0; i < texts.Length; i++) Console.WriteLine($"{texts[i]}: {results[i]}");
return results.All(r => r.StartsWith("200")) ? 0 : 1;
string Describe(Exception ex) => ex switch
{
// A cancelled submit surfaces as a NetworkException, a cancelled poll as a TaskCanceledException.
_ when budget.IsCancellationRequested => "the budget ran out",
ValidationException => "CapSkip refused the arguments: " + ex.Message,
ApiException => "CapSkip answered " + ex.Message,
SolverTimeout => "no answer in time: " + ex.Message,
NetworkException => "CapSkip is not reachable: " + ex.Message,
// HttpClient reports its own timeout as a TaskCanceledException.
TaskCanceledException => "the site did not answer within 20 seconds",
HttpRequestException => "the site could not be reached: " + ex.Message,
_ => ex.GetType().Name + ": " + ex.Message,
};हर submission अपना try block लपेटता है। Task.WhenAll सिर्फ़ पहली विफलता दोबारा throw करता है और रद्द हुए tasks में पढ़ने लायक कोई exception नहीं होती, इसलिए lambda के भीतर पकड़ने से हर नतीजा बचा रहता है। प्रोग्राम को dotnet run से शुरू करें। ये पंक्तियाँ mock के नतीजे हैं, और net10.0 व net8.0 पर एक जैसे थे।
| mock सेटिंग | प्रोग्राम ने क्या प्रिंट किया |
|---|---|
| डिफ़ॉल्ट mock सेटिंग्स | 200 और text की पाँच पंक्तियाँ, exit code 0 |
| हर हल 2 सेकंड बाद तैयार | एक साथ अधिकतम 3 हल, आख़िरी दो पहले तीन के 3.8 सेकंड बाद submit हुए, और पूरा रन लगभग 8 सेकंड का रहा |
| पहले दो हल फेल | API error वाली दो पंक्तियाँ, 200 वाली तीन, exit code 1 |
| mock साइट दो form post को 403 से ठुकराती है | दो 403 पंक्तियाँ, तीन 200 पंक्तियाँ, और कुछ भी retry नहीं हुआ |
| हर जवाब में isOffline true है | offline पास की पाँच पंक्तियाँ, भेजा नहीं गया, exit code 1 |
Cancellation और दो TimeoutException
CancellationToken SDK और HttpClient दोनों तक पहुँचता है, इसलिए एक budget पूरे batch को कवर करता है। कभी खत्म न होने वाले mock और 3 सेकंड के budget के साथ, पाँचों पंक्तियों ने बताया कि budget खत्म हो गया और प्रक्रिया लगभग 3.5 सेकंड बाद समाप्त हुई। in.php अटके होने पर cancel करने से NetworkException मिली जो TaskCanceledException को लपेटती है, और polling के दौरान cancel करने से सादा TaskCanceledException। Describe में पहले budget token जाँचना दोनों को सँभाल लेता है।
CapSkip अपना TimeoutException भी throw करता है जब polling अपनी सीमा से आगे निकल जाती है, और implicit usings System को import करते हैं, जिसमें भी एक है। using CapSkip के बगल में TimeoutException के लिए सादा catch CS0104 के साथ compile नहीं हुआ, इसीलिए Program.cs SDK की class को SolverTimeout नाम से alias करता है। HttpClient फिर भी आप पर System.TimeoutException नहीं फेंकता। 25 सेकंड सोती mock साइट और 20 की client सीमा के साथ, हर submission लगभग 20 सेकंड बाद TaskCanceledException बनकर लौटा, और पूरा रन कुल लगभग 20.6 सेकंड का रहा।
GeetestV4Async defaultTimeout नहीं, recaptchaTimeout इस्तेमाल करता है, जो डिफ़ॉल्ट रूप से 300 सेकंड है (changelog के अनुसार)। मैंने इसे जाँचा: defaultTimeout 1 और recaptchaTimeout 5 के साथ, कभी जवाब न देने वाले mock के सामने, exception net10.0 पर 7.87 सेकंड बाद और net8.0 पर 7.85 बाद आई। SDK लगभग 0, 0.25, 0.75, 1.75 और 3.75 सेकंड पर poll करता है और फिर 4 सेकंड और सोता है, इसलिए deadline का पता उस आख़िरी sleep के खत्म होने पर चलता है, आपके तय किए 5 सेकंड के काफ़ी बाद।
आम errors
| आप जो देखते हैं | कारण | फिक्स |
|---|---|---|
| ValidationException | किसी request से पहले ठुकराया: खाली captcha_id, ऐसा पेज पता जो पूरा http या https नहीं है, ऐसा risk_type जो string नहीं है, या v3 का gt या challenge जैसा कोई option | argument ठीक करें। retry से मदद नहीं मिल सकती |
| ApiException, ERROR_KEY_DOES_NOT_EXIST के साथ | mock ने key ठुकरा दी। docs के अनुसार, API Key Validation चालू होने और key अनजान होने पर असली app यही जवाब देता है | CapSkipClient में key दें |
| ERROR_CAPTCHA_UNSOLVABLE वाला ApiException | हल फेल हुआ। मैंने इसे mock से पैदा किया, और जाँच नहीं सका कि असली app विफल v4 हल को कैसे बताता है | दोबारा हल करें, और पुराना नतीजा कभी post न करें |
| NetworkException | CapSkip के host और port पर किसी ने जवाब नहीं दिया, या call रद्द कर दी गई | CapSkip शुरू करें, या CapSkipClient में host जाँचें |
| CapSkip TimeoutException | Polling recaptchaTimeout से आगे निकल गई, और SDK को अगली sleep खत्म होने पर ही पता चलता है | अगर आपके हल धीमे हैं तो recaptchaTimeout बढ़ाएँ |
| साइट 403 या 400 देती है | मेरे mock में: पहले इस्तेमाल हो चुका नतीजा, कोई गायब field, या offline पास। असली साइट अपने नियम ख़ुद तय करती है | एक ताज़े हल से पाँचों fields post करें |
Server mode: solver और host अलग मशीनों पर
यह host दूसरे PC पर चल सकता है जबकि CapSkip आपके नियंत्रण की किसी Windows मशीन पर रहता है। solver PC की कनेक्शन सेटिंग्स में Server mode चालू करें, फिर उस PC का पता CapSkipClient के host argument में रखें। कोड में और कुछ नहीं बदलता। setup guide के अनुसार Server mode के लिए CapSkip को administrator के रूप में चलना चाहिए। setup guide स्थिर पहुँच के लिए static public IP सुझाता है, और यह कनेक्शन सेटिंग्स को पूरी तरह समझाता है।
Server mode शुरू होने पर CapSkip अपना port हर पते के लिए खोल देता है। इसे उन मशीनों तक सीमित रखने के लिए जिनकी आपको उम्मीद है, बाकी सबके लिए Windows Firewall का block rule जोड़ें, और API Key Validation चालू करें ताकि CapSkipClient को key देनी पड़े।
FAQ
result property का नाम GeetestCaptchaId क्यों है?
CaptchaId पहले से लिया हुआ था: वह वह id है जो CapSkip हल को देता है। GeetestCaptchaId में GeeTest की वह captcha_id है जिसे widget दोहराता है, और यह उन पाँच fields में से एक है जो साइट वापस चाहती है।
क्या मैं एक CapSkipClient को कई threads में साझा कर सकता हूँ?
मैंने mock में एक ही instance से पाँच हल एक साथ बिना किसी समस्या के चलाए, और source हर call पर अपने parameters कॉपी करता है। मैंने इससे आगे टेस्ट नहीं किया। अगर आप इसे singleton के रूप में register करते हैं, जैसा ऊपर है, तो load को semaphore सीमित करता है।
C# में GeeTest v4 का मतलब है एक captcha_id पढ़ना, हर submission पर एक GeetestV4Async call और पाँच fields का साथ में post होना। CapSkip एक फिक्स्ड कीमत वाला कैप्चा सॉल्वर है जो आपके अपने PC पर चलता है, इसलिए ठुकराए जाने के बाद हर अतिरिक्त हल मुफ़्त है। .NET में दूसरे प्रकारों के लिए यह पेज देखें: C# कैप्चा सॉल्वर पेज, और request फ़ॉर्मैट के लिए यह पढ़ें: API docs का GeeTest v4 सेक्शन.
