ReCAPTCHA

Pangkalahatang-ideya

Ang Google reCAPTCHA ay ang pinakasikat na sistema ng captcha sa mundo, na ginagamit ng milyun-milyong website upang protektahan laban sa spam at mga bot. Kasalukuyang sinusuportahan ng Achicaptcha ang reCAPTCHA v2 na may mataas na rate ng tagumpay.

1. Lumikha ng Gawain

Request

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

Mga Parameter

Halimbawa ng Request

POST /createTask HTTP/1.1
Host: api.achicaptcha.com
Content-Type: application/json
 
{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "RecaptchaV2TaskProxyless",
    "websiteURL": "https://www.google.com/recaptcha/api2/demo",
    "websiteKey": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-"
  }
}

Response

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

2. Kunin ang Resulta

Request

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

Mga Parameter

Halimbawa ng Request

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

Response

{
  "errorId": 0,
  "status": "ready",
  "solution": "03AGdBq27QGA96FJRo3mtz..."
}

Paliwanag sa Status

• errorId = 0 at status = ready: Matagumpay na nalutas, basahin ang resulta sa solution
• errorId = 0 at status = processing: Nilulutas ang captcha, maghintay ng 2 segundo at subukang muli
• errorId > 0: Error sa system, nagbabalik ng error code at paglalarawan

Mga Halimbawa ng Integrasyon

import requests
import time
 
def solve_recaptcha_v2(website_url, website_key, api_key='YOUR_API_KEY'):
    # Hakbang 1: Lumikha ng gawain
    create_task_url = 'https://api.achicaptcha.com/createTask'
    create_task_payload = {
        'clientKey': api_key,
        'task': {
            'type': 'RecaptchaV2TaskProxyless',
            'websiteURL': website_url,
            'websiteKey': website_key
        }
    }
    
    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']
    
    # Hakbang 2: Kunin ang resulta
    get_result_url = 'https://api.achicaptcha.com/getTaskResult'
    
    while True:
        time.sleep(2)  # Maghintay ng 2 segundo
        
        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']
        
        # Kung status == 'processing', ipagpatuloy ang loop
 
# Paggamit
website_url = 'https://www.google.com/recaptcha/api2/demo'
website_key = '6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-'
token = solve_recaptcha_v2(website_url, website_key, 'YOUR_API_KEY')
print('reCAPTCHA token:', token)

Karaniwang Error Codes

Pinakamahuhusay na Kasanayan

1. I-validate ang Site Key

• Suriin ang site key bago magpadala ng request
• Tiyaking tumpak ang site key na nakuha mula sa data-sitekey attribute
• I-verify na ang website URL ay tumutugma sa page na naglalaman ng captcha

2. Hawakan ang mga Timeout

• Ang token ay may oras ng pag-expire (karaniwang 120 segundo)
• Gamitin ang token kaagad pagkatapos matanggap
• Huwag i-cache ang token nang masyadong matagal

3. Interval ng Polling

• Maghintay ng hindi bababa sa 2 segundo sa pagitan ng mga pagsusuri ng resulta
• Huwag i-spam ang API ng masyadong maraming magkakasunod na kahilingan
• Magtakda ng timeout upang maiwasan ang mga infinite loop (inirerekomenda ang 120 segundo)

4. Logic ng Pag-retry

• Ipatupad ang retry para sa mga pansamantalang error tulad ng ERROR_NO_SLOT_AVAILABLE
• Gumamit ng exponential backoff kapag nagre-retry
• Limitahan ang maximum na mga pagsubok sa pag-retry

5. Seguridad ng API Key

• Huwag i-hardcode ang API key sa code
• Gumamit ng mga environment variable
• Huwag ilantad ang API key sa client-side

Mga Kapaki-pakinabang na link:

• Achicaptcha Homepage (opens in a new tab)
• Panimula sa Achicaptcha
• I-install para sa Firefox (opens in a new tab)
• I-install para sa Chrome (opens in a new tab)