Skip to content
API
Text Captcha

Text Captcha

अवलोकन

एक मानक टेक्स्ट कैप्चा एक छवि है जिसमें विकृत पाठ होता है जो मनुष्यों द्वारा पठनीय होता है। कैप्चा छवि को हल करने के लिए, उपयोगकर्ताओं को छवि से पाठ दर्ज करना होगा।

📝

टेक्स्ट कैप्चा में संख्याएं, अक्षर या दोनों का संयोजन शामिल हो सकता है। वे आम तौर पर स्वचालित पढ़ने को मुश्किल बनाने के लिए छवि विकृतियों, शोर और विभिन्न फोंट का उपयोग करते हैं।

Common text captcha

1. कार्य बनाएँ

अनुरोध

POST https://api.achicaptcha.com/createTask

पैरामीटर्स

पैरामीटरडेटा प्रकारआवश्यक?विवरण
clientKeystringहाँAPI key
task.typestringहाँImageToTextTask
task.imagestringहाँछवि का Base64
task.subTypestringहाँनिम्नलिखित प्रकारों में से एक: common, amazon, microsoft, facebook, garena, artistshot, gmx, 11166, houssam

अनुरोध उदाहरण

POST /createTask HTTP/1.1
Host: api.achicaptcha.com
Content-Type: application/json
 
{
  "clientKey": "Your API_KEY",
  "task": {
    "type": "ImageToTextTask",
    "image": "base64 encoded image",
    "subType": "gmx"
  }
}

प्रतिक्रिया

सफल होने पर, सर्वर errorId = 0 और taskId लौटाएगा

{
  "errorId": 0,
  "taskId": "f2fc70d6-c76b-4fba-9480-205ac1fe9fb9"
}

2. परिणाम प्राप्त करें

अनुरोध

POST https://api.achicaptcha.com/getTaskResult

पैरामीटर्स

पैरामीटरडेटा प्रकारआवश्यक?विवरण
clientKeystringहाँAPI key
taskIdstringहाँचरण (1) से TaskId

अनुरोध उदाहरण

POST /getTaskResult HTTP/1.1
Host: api.achicaptcha.com
Content-Type: application/json
 
{
  "clientKey": "Your API_KEY",
  "taskId": "f2fc70d6-c76b-4fba-9480-205ac1fe9fb9"
}

प्रतिक्रिया

{
  "errorId": 0,
  "status": "ready",
  "solution": "swamn"
}

स्थिति स्पष्टीकरण

  • errorId = 0 और status = ready: सफलतापूर्वक हल किया गया, solution.text में परिणाम पढ़ें
  • errorId = 0 और status = processing: कैप्चा हल किया जा रहा है, 2 सेकंड प्रतीक्षा करें और पुनः प्रयास करें
  • errorId > 0: सिस्टम त्रुटि, त्रुटि कोड और विवरण प्रदान किया गया

SubType विकल्प

Achicaptcha subType पैरामीटर के माध्यम से विभिन्न प्रकार के टेक्स्ट कैप्चा का समर्थन करता है:

SubTypeविवरण
commonसामान्य टेक्स्ट कैप्चा, सबसे लोकप्रिय
amazonविशेष विरूपण के साथ अमेज़ॅन-विशिष्ट कैप्चा
microsoftMicrosoft सेवाओं पर उपयोग किया जाने वाला कैप्चा
facebookविशिष्ट फोंट के साथ फेसबुक कैप्चा
garenaGarena प्लेटफॉर्म पर कैप्चा
artistshotArtistshot वेबसाइट से कैप्चा
gmxGMX ईमेल कैप्चा
11166कोड 11166 के साथ विशेष कैप्चा प्रकार
houssamHoussam नामक विशिष्ट कैप्चा प्रकार
discordDiscord-विशिष्ट कैप्चा प्रकार
okvipOKVIP-विशिष्ट कैप्चा प्रकार
shopeeShopee-विशिष्ट कैप्चा प्रकार
📝

आमतौर पर subType: common सभी प्रकार के टेक्स्ट कैप्चा को संभाल सकता है। यदि आपकी वेबसाइट का टेक्स्ट कैप्चा बहुत विशिष्ट है, तो कृपया सहायता के लिए admin (opens in a new tab) से संपर्क करें।

एकीकरण उदाहरण

import requests
import time
import base64
 
def solve_captcha(image_path, sub_type='common', api_key='YOUR_API_KEY'):
    # Read and encode image
    with open(image_path, 'rb') as image_file:
        image_base64 = base64.b64encode(image_file.read()).decode('utf-8')
    
    # Step 1: Create task
    create_task_url = 'https://api.achicaptcha.com/createTask'
    create_task_payload = {
        'clientKey': api_key,
        'task': {
            'type': 'ImageToTextTask',
            'image': image_base64,
            'subType': sub_type
        }
    }
    
    response = requests.post(create_task_url, json=create_task_payload)
    result = response.json()
    
    if result['errorId'] != 0:
        raise Exception(result['errorDescription'])
    
    task_id = result['taskId']
    
    # Step 2: Get result
    get_result_url = 'https://api.achicaptcha.com/getTaskResult'
    
    while True:
        time.sleep(2)  # Wait 2 seconds
        
        get_result_payload = {
            'clientKey': api_key,
            'taskId': task_id
        }
        
        response = requests.post(get_result_url, json=get_result_payload)
        result = response.json()
        
        if result['errorId'] != 0:
            raise Exception(result['errorDescription'])
        
        if result['status'] == 'ready':
            return result['solution']
        
        # If status == 'processing', continue loop
 
# Usage
solution = solve_captcha('captcha.png', 'common', 'YOUR_API_KEY')
print('Captcha result:', solution)

सामान्य त्रुटि कोड

त्रुटि कोडविवरणनोट्स
0successसफलता
1processingप्रसंस्करण
2missing required fieldsआवश्यक फ़ील्ड गायब है, पैरामीटर की जाँच करें
3task not supportedकार्य प्रकार समर्थित नहीं है
4task creation failedकार्य निर्माण विफल
5client key does not existAPI कुंजी मौजूद नहीं है, अपनी API कुंजी की जाँच करें
6insufficient account balanceअपर्याप्त खाता शेष, क्रेडिट टॉप अप करें
7task failed, please create a new taskकार्य विफल, कृपया एक नया कार्य बनाएँ
8task ID does not existकार्य ID मौजूद नहीं है

सर्वोत्तम प्रथाएँ

Achicaptcha API का उपयोग करते समय सर्वोत्तम परिणाम प्राप्त करने के लिए, इन सिद्धांतों का पालन करें:

1. छवि गुणवत्ता

  • अच्छे रिज़ॉल्यूशन वाली छवियों का उपयोग करें
  • सुनिश्चित करें कि छवियां बहुत धुंधली या शोरगुल वाली नहीं हैं
  • अपने कैप्चा प्रकार के लिए उपयुक्त subType चुनें

2. पोलिंग अंतराल

  • परिणाम जाँचों के बीच कम से कम 2 सेकंड प्रतीक्षा करें
  • बहुत अधिक लगातार अनुरोधों के साथ API को स्पैम न करें
  • अनंत लूप से बचने के लिए टाइमआउट रखें

3. पुनः प्रयास तर्क

  • ERROR_NO_SLOT_AVAILABLE जैसी अस्थायी त्रुटियों के लिए पुनः प्रयास लागू करें
  • पुनः प्रयास करते समय घातीय बैकऑफ़ (exponential backoff) का उपयोग करें
  • अधिकतम पुनः प्रयास प्रयासों को सीमित करें

4. API कुंजी सुरक्षा

  • कोड में API कुंजी को हार्डकोड न करें
  • पर्यावरण चर (environment variables) का उपयोग करें
  • क्लाइंट-साइड पर API कुंजी को उजागर न करें

उपयोगी लिंक: