Skip to content
API
Shopee Captcha

Shopee Captcha

अवलोकन

Shopee Captcha एक कैप्चा प्रणाली है जिसका उपयोग Shopee उपयोगकर्ताओं और सिस्टम को बॉट्स, स्पैम या स्वचालित लॉगिन जैसे असामान्य व्यवहार से बचाने के लिए करता है।

Achicaptcha विभिन्न प्लेटफार्मों (ब्राउज़र, एमुलेटर, फोन) के लिए स्वचालित Shopee कैप्चा समाधान का समर्थन करता है। API को एकीकृत करने के लिए नीचे दी गई गाइड देखें।

🛍️

Shopee टेक्स्ट कैप्चा के लिए, कृपया Text Captcha देखें। यदि आपको कोई समस्या आती है, तो कृपया सहायता के लिए admin (opens in a new tab) से संपर्क करें।

Shopee Slider Captcha 1Shopee Slider Captcha 2

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

अनुरोध

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

पैरामीटर्स

पैरामीटरडेटा प्रकारआवश्यक?विवरण
clientKeystringहाँAPI key
task.typestringहाँShopeeCaptchaTask
task.imagestringहाँBase64 मास्क छवि|Base64 पृष्ठभूमि छवि
task.subTypeintहाँकैप्चा प्रकार:
0: स्लाइडर कैप्चा

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

POST /createTask HTTP/1.1
Host: api.achicaptcha.com
Content-Type: application/json
 
{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "ShopeeCaptchaTask",
    "image": "/9j/4AAQSkZJRgABAQEASABIAAD...|/9j/4DSJFHKSDJDS...",
    "subType": 0
  }
}

प्रतिक्रिया

सफल होने पर, सर्वर 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": "x1,y1,x2,y2"
}

प्रतिक्रिया का अर्थ

  • errorId = 0 और status = ready: सफलतापूर्वक हल किया गया, solution में परिणाम पढ़ें
  • errorId = 1 और status = processing: कैप्चा हल किया जा रहा है, 1-2 सेकंड प्रतीक्षा करें और पुनः प्रयास करें
  • errorId 0 और 1 के अलावा: सिस्टम त्रुटि, त्रुटि कोड और विवरण प्रदान किया गया
  • solution: स्लाइडर कैप्चा के लिए: खींचने के लिए x-अक्ष निर्देशांक लौटाता है

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

import requests
import time
 
def solve_shopee_captcha(mask_image, bg_image, sub_type, api_key='YOUR_API_KEY'):
    # Step 1: Create task
    create_task_url = 'https://api.achicaptcha.com/createTask'
    create_task_payload = {
        'clientKey': api_key,
        'task': {
            'type': 'ShopeeCaptchaTask',
            'image': mask_image + '|' + bg_image,
            '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 and result['status'] == 'ready':
            return result['solution']
        
        if result['errorId'] != 0 and result['errorId'] != 1:
            raise Exception(result['errorDescription'])
        
        # If status == 'processing', continue loop
 
# Usage
mask_image = '/9j/4AAQSkZJRgABAQEASABIAAD...'  # Base64 mask image
bg_image = '/9j/4DSJFHKSDJDS...'  # Base64 background image
sub_type = 0  # 0: Slider captcha
solution = solve_shopee_captcha(mask_image, bg_image, sub_type, 'YOUR_API_KEY')
print('Shopee captcha solution:', solution)

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

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

त्रुटि कोडविवरणनोट्स
0successकार्य सफलतापूर्वक बनाया गया
2missing required fieldsआवश्यक फ़ील्ड गायब है, पैरामीटर (image, subType) की जाँच करें
3task not supportedकार्य प्रकार समर्थित नहीं है
4task creation failedकार्य निर्माण विफल, बाद में पुनः प्रयास करें
5client key does not existAPI कुंजी मौजूद नहीं है, अपनी API कुंजी की जाँच करें
6insufficient account balanceअपर्याप्त खाता शेष, क्रेडिट टॉप अप करें

परिणाम प्राप्त करते समय त्रुटि कोड

त्रुटि कोडविवरणनोट्स
0successसफलता, solution फ़ील्ड में परिणाम पढ़ें
1processingप्रसंस्करण, 1-2 सेकंड प्रतीक्षा करें और अनुरोध फिर से भेजें
5client key does not existAPI कुंजी मौजूद नहीं है, अपनी API कुंजी की जाँच करें
7task failed, please create a new taskकार्य विफल, कृपया एक नया कार्य बनाएँ
8task ID does not existकार्य ID मौजूद नहीं है या समाप्त हो गया है

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

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

1. Base64 चित्र तैयार करें

  • मास्क और पृष्ठभूमि छवियों को Base64 प्रारूप में बदलें
  • सटीकता बढ़ाने के लिए सुनिश्चित करें कि छवि गुणवत्ता स्पष्ट है
  • दो छवियों को | (पाइप) वर्ण के साथ जोड़ें

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

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

3. त्रुटि प्रबंधन

  • त्रुटियों का पता लगाने के लिए errorId की जाँच करें
  • errorId = 0 और status = ready: सफलता
  • errorId = 1: प्रसंस्करण, पोलिंग जारी रखें
  • errorId 0 और 1 के अलावा: सिस्टम त्रुटि, प्रबंधन की आवश्यकता है

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

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

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

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

उपयोगी लिंक: