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

​
Вступ

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

​
Передумови

  • Мати акаунт Ace Data Cloud та отримати API Token
  • Встановлене середовище терміналу з cURL

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

Основна кінцева точка для виклику reCAPTCHA API: 
POST https://api.acedata.cloud/captcha/token/recaptcha2
Повний приклад команди cURL: 
curl -X POST https://api.acedata.cloud/captcha/token/recaptcha2 \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"website_key": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-", "website_url": "https://www.google.com/recaptcha/api2/demo"}'
Будь ласка, замініть YOUR_API_TOKEN на фактичний токен, отриманий на платформі Ace Data Cloud.

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

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

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

Рекомендується використовувати інструмент jq для форматованого виводу: 
curl -s -X POST https://api.acedata.cloud/captcha/token/recaptcha2 \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"website_key": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-", "website_url": "https://www.google.com/recaptcha/api2/demo"}' | jq .

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

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

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