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

1. कार्य बनाएँ
अनुरोध
POST https://api.achicaptcha.com/createTask
पैरामीटर्स
| पैरामीटर | डेटा प्रकार | आवश्यक? | विवरण |
|---|---|---|---|
clientKey | string | हाँ | API key |
task.type | string | हाँ | ImageToTextTask |
task.image | string | हाँ | छवि का Base64 |
task.subType | string | हाँ | निम्नलिखित प्रकारों में से एक: 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
पैरामीटर्स
| पैरामीटर | डेटा प्रकार | आवश्यक? | विवरण |
|---|---|---|---|
clientKey | string | हाँ | API key |
taskId | string | हाँ | चरण (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 | विशेष विरूपण के साथ अमेज़ॅन-विशिष्ट कैप्चा |
microsoft | Microsoft सेवाओं पर उपयोग किया जाने वाला कैप्चा |
facebook | विशिष्ट फोंट के साथ फेसबुक कैप्चा |
garena | Garena प्लेटफॉर्म पर कैप्चा |
artistshot | Artistshot वेबसाइट से कैप्चा |
gmx | GMX ईमेल कैप्चा |
11166 | कोड 11166 के साथ विशेष कैप्चा प्रकार |
houssam | Houssam नामक विशिष्ट कैप्चा प्रकार |
discord | Discord-विशिष्ट कैप्चा प्रकार |
okvip | OKVIP-विशिष्ट कैप्चा प्रकार |
shopee | Shopee-विशिष्ट कैप्चा प्रकार |
आमतौर पर 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)सामान्य त्रुटि कोड
| त्रुटि कोड | विवरण | नोट्स |
|---|---|---|
| 0 | success | सफलता |
| 1 | processing | प्रसंस्करण |
| 2 | missing required fields | आवश्यक फ़ील्ड गायब है, पैरामीटर की जाँच करें |
| 3 | task not supported | कार्य प्रकार समर्थित नहीं है |
| 4 | task creation failed | कार्य निर्माण विफल |
| 5 | client key does not exist | API कुंजी मौजूद नहीं है, अपनी API कुंजी की जाँच करें |
| 6 | insufficient account balance | अपर्याप्त खाता शेष, क्रेडिट टॉप अप करें |
| 7 | task failed, please create a new task | कार्य विफल, कृपया एक नया कार्य बनाएँ |
| 8 | task 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 कुंजी को उजागर न करें
उपयोगी लिंक: