API दस्तावेज़ीकरण
तीन एंडपॉइंट, छह भाषाओं में पूरे कोड उदाहरण। Capzy के हाई-परफ़ॉर्मेंस सॉल्वर क्लस्टर के साथ 60 सेकंड से कम में इंटीग्रेट करें।
क्विक स्टार्ट
POST /createTaskकैप्चा प्रकार + साइट पैरामीटर सबमिट करें। तुरंत एक taskId वापस पाएं।
POST /getTaskResultस्टेटस ready होने तक ~1 सेकंड पर पोल करें। टोकन solution ऑब्जेक्ट में आता है।
POST /getBalanceबाकी क्रेडिट जांचें। विफल सॉल्व यहां अपने आप रिफ़ंड होते हैं।
https://api.capzy.aiअनुरोध बॉडी में clientKey से ऑथएंडपॉइंट
/createTaskनया कैप्चा सॉल्विंग टास्क बनाएं{
"clientKey": "capzy_...",
"task": {
"type": "AntiTurnstileTaskProxyLess",
"websiteURL": "https://example.com",
"websiteKey": "0x4AAA..."
}
}{
"errorId": 0,
"taskId": "df944101-64ac-468d-bc9f-41baecc3b8ca",
"status": "processing"
}/getTaskResultटास्क नतीजे के लिए पोल करें{
"clientKey": "capzy_...",
"taskId": "df944101-64ac-468d-bc9f-41baecc3b8ca"
}{
"errorId": 0,
"status": "ready",
"solution": {
"token": "0.eyJhbGci..."
}
}/getBalanceखाता बैलेंस जांचें{ "clientKey": "capzy_..." }{ "errorId": 0, "balance": 9.50 }/reportScoreवैकल्पिक: V3 टास्क के लिए Google का सत्यापित स्कोर वापस रिपोर्ट करें। आपके डैशबोर्ड के V3 क्वालिटी व्यू को चलाता है। प्रति टास्क एक रिपोर्ट; रिपोर्ट सॉल्व पूरा होने के 24 घंटे के भीतर आनी चाहिए।{
"clientKey": "capzy_...",
"taskId": "df944101-64ac-468d-bc9f-41baecc3b8ca",
"score": 0.9,
"action": "login",
"hostname": "example.com"
}{ "errorId": 0 }/reportCorrectCaptchaवैकल्पिक: हमें बताएं कि टार्गेट साइट ने सॉल्व को स्वीकार किया। खास तौर पर कोऑर्डिनेट लौटाने वाले प्रकारों (जैसे Shopee स्लाइडर) के लिए उपयोगी, जहां हम एक पोज़िशन लौटाते हैं और आपका अपना ब्राउज़र ड्रैग करता है। यह रिपोर्ट वास्तविक दुनिया की सटीकता का हमारा एकमात्र संकेत है। प्रति टास्क एक रिपोर्ट, 24 घंटे के भीतर; मूल्य पर कभी असर नहीं पड़ता।{
"clientKey": "capzy_...",
"taskId": "df944101-64ac-468d-bc9f-41baecc3b8ca"
}{ "errorId": 0 }/reportIncorrectCaptchaवैकल्पिक: हमें बताएं कि टार्गेट साइट ने सॉल्व को अस्वीकार किया। यह /reportCorrectCaptcha जैसी ही वास्तविक सटीकता ट्रैकिंग में जाता है। प्रति टास्क एक रिपोर्ट, 24 घंटे के भीतर; मूल्य पर कभी असर नहीं पड़ता।{
"clientKey": "capzy_...",
"taskId": "df944101-64ac-468d-bc9f-41baecc3b8ca"
}{ "errorId": 0 }समर्थित टास्क प्रकार
लोड हो रहा है…मौजूदा सक्षम टास्क प्रकारों की लाइव सूची, कैप्चा प्रदाता के अनुसार समूहित। मूल्य और औसत सॉल्व समय क्लस्टर टेलीमेट्री से अपने आप अपडेट होते हैं।
रेट लिमिट
सीमाएं प्रति खाता लागू होती हैं, आपकी सभी API कुंजियों को मिलाकर। सीमा से अधिक होने पर क्रेडिट खर्च किए बिना एक त्रुटि कोड लौटता है।
हर नया खाता यहीं से शुरू होता है
अपनी अपेक्षित मात्रा के साथ सपोर्ट टिकट खोलें (कोई अलग मूल्य टियर नहीं, वही प्रति-सॉल्व दर)
समवर्ती टास्कसॉल्व कतार में एक साथ आपके कितने टास्क हो सकते हैं। एक टास्क createTask से लेकर उसके पूरा होने (सफलता, विफलता या टाइमआउट) तक आपकी सीमा में गिना जाता है।
रेट लिमिटआप प्रति सेकंड कितनी createTask कॉल कर सकते हैं। स्लाइडिंग विंडो, प्रति खाता लागू। रेट से अधिक होने पर ERROR_RATE_LIMITED लौटता है और कोई क्रेडिट नहीं कटता।
त्रुटि कोड
/createTask / /getTaskResult द्वारा लौटाई गई हर त्रुटि, समाधान के साथ। विफल सॉल्व अपने आप रिफ़ंड होते हैं: क्रेडिट तुरंत आपके बैलेंस में लौट आते हैं।
ऑथेंटिकेशन
आपकी API कुंजी या IP से जुड़ी समस्याएं।- #
ERROR_KEY_DOES_NOT_EXISTआपकी API कुंजी पहचानी नहीं गई।
समाधानDashboard → API Keys में मान दोबारा जांचें। कुंजियां `capzy_` से शुरू होती हैं। रोटेट की गई कुंजियां तुरंत अमान्य हो जाती हैं।
- #
ERROR_IP_NOT_ALLOWEDआपके अनुरोध का IP API कुंजी की अनुमति सूची में नहीं है।
समाधानDashboard → API Keys में कुंजी की अनुमति सूची में अपना IP जोड़ें, या अगर IP पिनिंग की ज़रूरत नहीं है तो अनुमति सूची पूरी तरह हटा दें।
- #
ERROR_IP_BLOCKEDबहुत अधिक अमान्य अनुरोध भेजने के कारण आपका IP अस्थायी रूप से बैन है।
समाधानहम उन IP को बैन करते हैं जो 10 मिनट में 100+ अमान्य अनुरोध भेजते हैं (बढ़ते क्रम में)। अमान्य अनुरोधों का कारण बनने वाला बग ठीक करें, फिर इंतज़ार करें। टियर के आधार पर बैन 1 मिनट से 24 घंटे तक में अपने आप समाप्त हो जाते हैं।
वैलिडेशन
गलत टास्क पैरामीटर या sitekey के लिए गलत प्रकार।- #
ERROR_INVALID_PARAMSअनुरोध बॉडी गलत थी या आवश्यक फ़ील्ड गायब थे।
समाधानजांचें कि `clientKey` सबसे ऊपरी स्तर पर है और `task` में `type` के साथ आवश्यक पहचानकर्ता (websiteURL/websiteKey/captchaId/आदि) है। हर प्रकार के आवश्यक पैरामीटर के लिए Task Types सेक्शन देखें।
- #
ERROR_BAD_SITEKEY`websiteKey` किसी ऐसे कैप्चा प्रदाता के साथ पंजीकृत नहीं है जिसे हम पहचान सकें।
समाधानसुनिश्चित करें कि आप टार्गेट पेज से पूरी sitekey कॉपी कर रहे हैं (`data-sitekey`, `sitekey:`, या `grecaptcha.render` / `hcaptcha.render` में पैरामीटर देखें)।
- #
ERROR_TASK_NOT_SUPPORTEDआपके द्वारा सबमिट किया गया टास्क `type` ऐसा कैप्चा प्रकार नहीं है जिसे Capzy अभी सपोर्ट करता है।
समाधानपूरी सक्षम सूची के लिए नीचे Task Types सेक्शन देखें। अगर आपको कोई ऐसा कैप्चा चाहिए जो सूची में नहीं है, तो टिकट खोलें और हम उसे प्राथमिकता देंगे।
- #
ERROR_WRONG_TASK_TYPEटास्क प्रकार sitekey के वास्तविक प्रदाता से मेल नहीं खाता।
समाधानहम sitekey को उनके असली प्रदाता के विरुद्ध पहले से जांचते हैं। त्रुटि रिस्पॉन्स में एक `recommended` फ़ील्ड होता है: उस टास्क प्रकार पर स्विच करें। (कोई क्रेडिट नहीं कटता।)
- #
ERROR_PROXY_REQUIREDयह कैप्चा IP-बाउंड है: इसके टोकन उस IP से जुड़े होते हैं जिसने इन्हें हल किया।
समाधान`*Task` वेरिएंट पर स्विच करें (`*TaskProxyLess` के बजाय) और वह `proxyAddress` पास करें जो उस IP से मेल खाए जिससे आप टोकन सबमिट करेंगे। प्रभावित: Cloudflare Challenge, CaptchaFox, AWS WAF, DataDome, PerimeterX, Kasada, Akamai, Imperva।
- #
ERROR_NO_PROXYइस टास्क प्रकार के लिए प्रॉक्सी फ़ील्ड आवश्यक हैं लेकिन वे गायब थे।
समाधानअपनी टास्क बॉडी में `proxyType`, `proxyAddress`, `proxyPort` (और वैकल्पिक रूप से `proxyLogin`/`proxyPassword`/`userAgent`) शामिल करें।
- #
ERROR_PROXY_CONNECT_REFUSEDआपकी दी गई प्रॉक्सी ने कनेक्शन अस्वीकार कर दिया।
समाधानप्रॉक्सी क्रेडेंशियल, होस्ट की पहुंच और IP सक्रिय है या नहीं, यह जांचें। प्रदाता की समस्याएं अलग करने के लिए पहले उसी प्रॉक्सी को अपनी मशीन से आज़माएं।
रेट लिमिट
समवर्ती / प्रति-सेकंड / रिफ़ंड-अनुपात सीमाएं।- #
ERROR_MAX_TASKS_REACHEDआप अपने खाता टियर की समवर्ती-टास्क सीमा तक पहुंच गए हैं।
समाधानऔर सबमिट करने से पहले चल रहे टास्क पूरे होने का इंतज़ार करें। डिफ़ॉल्ट Regular टियर में 30 समवर्ती हैं; अपग्रेड के लिए सपोर्ट से संपर्क करें।
- #
ERROR_RATE_LIMITEDआप अपनी रेट लिमिट से तेज़ /createTask सबमिट कर रहे हैं।
समाधानगति कम करें और दोबारा प्रयास करें। डिफ़ॉल्ट Regular टियर 30 अनुरोध/सेकंड स्लाइडिंग विंडो है। रेट से अधिक होने पर क्रेडिट नहीं कटते।
- #
ERROR_NO_SLOT_AVAILABLEक्लस्टर की क्षमता अस्थायी रूप से भरी हुई है।
समाधानकुछ सेकंड बाद दोबारा प्रयास करें (यह अस्थायी है)। अगर यह मिनटों तक बना रहे, तो status.capzy.ai देखें।
- #
ERROR_SYSTEM_MAINTENANCECapzy निर्धारित मेंटेनेंस में है।
समाधानमेंटेनेंस अवधि के बाद दोबारा प्रयास करें। हम स्टेटस पेज पर पहले से सूचना देते हैं।
सॉल्व परिणाम
सॉल्वर ने क्या लौटाया। विफल सॉल्व अपने आप रिफ़ंड होते हैं।- #
ERROR_TIMEOUTटास्क प्रति-प्रकार की टाइमआउट सीमा में पूरा नहीं हुआ।
समाधानअपने आप रिफ़ंड, कोई शुल्क नहीं। अधिकांश टाइमआउट अस्थायी होते हैं। अगर कोई खास कैप्चा लगातार टाइमआउट होता है, तो टास्क UUID के साथ टिकट खोलें।
- #
ERROR_CAPTCHA_UNSOLVABLEसॉल्वर ने इस चैलेंज पर अपने सभी रीट्राई खत्म कर दिए।
समाधानअपने आप रिफ़ंड, कोई शुल्क नहीं। आम कारण: पुरानी sitekey, websiteURL एम्बेड करने वाले डोमेन से मेल नहीं खाता, टार्गेट साइट ने कैप्चा बंद कर दिया।
- #
ERROR_NULL_RESULTसॉल्वर पूरा हुआ लेकिन कोई टोकन नहीं लौटाया।
समाधानअपने आप रिफ़ंड। आमतौर पर इसका मतलब है कि टार्गेट साइट ने सॉल्व के बीच में कैप्चा हटा दिया। दोबारा प्रयास करें; अगर बना रहे, तो टिकट खोलें।
- #
ERROR_INTERNALसॉल्व पाइपलाइन के अंदर अप्रत्याशित त्रुटि।
समाधानअपने आप रिफ़ंड। दोबारा प्रयास करें (ये दुर्लभ हैं)। अगर आप इन्हें लगातार देखते हैं, तो टास्क UUID के साथ टिकट खोलें।
- #
ERROR_ZERO_BALANCEटास्क की लागत के लिए खाते का बैलेंस बहुत कम है।
समाधानDashboard → Billing से क्रेडिट जोड़ें। विफल सॉल्व अपने आप रिफ़ंड होते हैं, इसलिए आप केवल सफल टोकन का भुगतान करते हैं।
स्कोर रिपोर्टिंग
/reportScore (V3 क्वालिटी फ़ीडबैक) से जुड़ी खास त्रुटियां।- #
ERROR_TASK_NOT_FOUND/reportScore: taskId आपके खाते का नहीं है या हटा दिया गया है।
समाधानस्कोर रिपोर्ट आपके स्वामित्व वाले टास्क का संदर्भ देनी चाहिए और सॉल्व पूरा होने के 24 घंटे के भीतर दर्ज होनी चाहिए।
- #
ERROR_TASK_NOT_READY/reportScore: टास्क अभी प्रोसेस हो रहा है या पहले ही विफल हो चुका है।
समाधानकेवल `ready` टास्क को स्कोर किया जा सकता है। रिपोर्ट करने से पहले /getTaskResult के ready लौटाने का इंतज़ार करें।
- #
ERROR_REPORT_TOO_LATE/reportScore: सॉल्व पूरा होने के बाद 24 घंटे से अधिक बीत चुके हैं।
समाधानअपनी siteverify कॉल के कुछ मिनटों के भीतर स्कोर रिपोर्ट करें। तभी डेटा हमारे V3 क्वालिटी डैशबोर्ड के लिए सबसे उपयोगी होता है।
कोड प्लेग्राउंड
हर प्रमुख भाषा में पूरे काम करने वाले उदाहरण। कॉपी करें, अपनी API कुंजी पेस्ट करें, चलाएं।
import requests, time
API = "https://api.capzy.ai"
KEY = "capzy_your_key_here"
# Create task
task = requests.post(f"{API}/createTask", json={
"clientKey": KEY,
"task": {
"type": "AntiTurnstileTaskProxyLess",
"websiteURL": "https://example.com",
"websiteKey": "0x4AAA..."
}
}).json()
task_id = task["taskId"]
# Poll for result
while True:
result = requests.post(f"{API}/getTaskResult", json={
"clientKey": KEY,
"taskId": task_id
}).json()
if result["status"] == "ready":
token = result["solution"]["token"]
print(f"Solved: {token[:50]}...")
break
elif result["status"] == "failed":
print(f"Failed: {result.get('errorDescription')}")
break
time.sleep(1)60 सेकंड से कम में इंटीग्रेट करें।
साइन अप पर $0.10 फ़्री क्रेडिट। क्रेडिट कार्ड की ज़रूरत नहीं।
अपनी फ़्री API कुंजी पाएं →