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

​
Вступ

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

​
Передумови

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

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

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

url = "https://api.acedata.cloud/captcha/token/hcaptcha"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "website_key": "a5f74b19-9e45-40e0-b45d-47ff91b7a6c2",
    "website_url": "https://accounts.hcaptcha.com/demo"
}

response = requests.post(url, headers=headers, json=data)
result = response.json()
print(result)
Будь ласка, замініть YOUR_API_TOKEN на фактичний 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Внутрішня помилка сервера

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

Сервіс hCaptcha також надає такі кінцеві точки:
  • POST https://api.acedata.cloud/captcha/recognition/hcaptcha

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