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

Вступ

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

Передумови

  • Наявність облікового запису Ace Data Cloud та отримання API Token
  • Встановлене середовище терміналу з cURL

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

Головна кінцева точка для виклику hCaptcha API:
POST https://api.acedata.cloud/captcha/token/hcaptcha
Повний приклад команди cURL:
curl -X POST https://api.acedata.cloud/captcha/token/hcaptcha \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"website_key": "a5f74b19-9e45-40e0-b45d-47ff91b7a6c2", "website_url": "https://accounts.hcaptcha.com/demo"}'
Будь ласка, замініть YOUR_API_TOKEN на фактичний Token, отриманий на платформі Ace Data Cloud.

Приклад відповіді

Після успішного виклику повертається дані у форматі JSON, наприклад:
{
  "status": "success",
  "data": {
    ...
  }
}

Обробка відповіді за допомогою jq

Рекомендується використовувати інструмент jq для форматованого виводу:
curl -s -X POST https://api.acedata.cloud/captcha/token/hcaptcha \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"website_key": "a5f74b19-9e45-40e0-b45d-47ff91b7a6c2", "website_url": "https://accounts.hcaptcha.com/demo"}' | jq .

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

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

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