Перейти до основного вмісту

​
Вступ

reCAPTCHA — це сервіс капчі, який надає Ace Data Cloud, рішення Google reCAPTCHA. Через уніфікований API Ace Data Cloud ви можете швидко інтегрувати reCAPTCHA за допомогою Python, реалізуючи функції reCAPTCHA v2 Token, розпізнавання reCAPTCHA v2, reCAPTCHA v3 Token тощо.

​
Передумови

  • Наявність облікового запису Ace Data Cloud та отримання API Token
  • Середовище Python 3.7 і вище
  • Встановлена бібліотека requests: pip install requests

​
Базове використання

Основна кінцева точка для виклику reCAPTCHA API: 
POST https://api.acedata.cloud/captcha/token/recaptcha2
Повний приклад коду на Python: 
import requests

url = "https://api.acedata.cloud/captcha/token/recaptcha2"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "website_key": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-",
    "website_url": "https://www.google.com/recaptcha/api2/demo"
}

response = requests.post(url, headers=headers, json=data)
result = response.json()
print(result)
Будь ласка, замініть YOUR_API_TOKEN на фактичний токен, отриманий на платформі Ace Data Cloud.

​
Обробка відповіді

Після успішного виклику API повертає дані у форматі JSON. Рекомендується перевіряти HTTP статус код: 
if response.status_code == 200:
    result = response.json()
    print("Виклик успішний:", result)
else:
    print(f"Виклик не вдався, статус код: {response.status_code}")
    print(response.text)

​
Розширене використання

Для API, що підтримують асинхронні завдання, можна отримати результат через callback URL: 
data['callback_url'] = 'https://your-server.com/callback'
response = requests.post(url, headers=headers, json=data)
# Результат буде надіслано на ваш сервер через callback URL

​
Обробка помилок

Поширені коди помилок:
Код стануОпис
401Помилка автентифікації, перевірте API Token
403Недостатньо коштів або відсутній дозвіл на доступ
429Перевищено ліміт частоти запитів
500Внутрішня помилка сервера

​
Інші кінцеві точки

Сервіс reCAPTCHA також надає наступні кінцеві точки:
  • POST https://api.acedata.cloud/captcha/recognition/recaptcha2
  • POST https://api.acedata.cloud/captcha/token/recaptcha3

​
Наступні кроки