reCAPTCHA JavaScript швидкий старт

Вступ

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

Передумови

Мати акаунт Ace Data Cloud та отримати API Token
Node.js 18+ або сучасне браузерне середовище

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

Основна кінцева точка для виклику reCAPTCHA API:

POST https://api.acedata.cloud/captcha/token/recaptcha2

Повний приклад коду на JavaScript:

const response = await fetch("https://api.acedata.cloud/captcha/token/recaptcha2", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "website_key": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-",
  "website_url": "https://www.google.com/recaptcha/api2/demo"
}),
});

const result = await response.json();
console.log(result);

Будь ласка, замініть YOUR_API_TOKEN на фактичний токен, отриманий на платформі Ace Data Cloud.

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

Рекомендується перевіряти статус відповіді та обробляти помилки:

if (response.ok) {
  const result = await response.json();
  console.log("Виклик успішний:", result);
} else {
  console.error(`Виклик не вдався, код стану: ${response.status}`);
  const error = await response.text();
  console.error(error);
}

Обгортка для Node.js

Рекомендується обгорнути у повторно використовувану функцію:

async function callreCAPTCHA(data) {
  const response = await fetch("https://api.acedata.cloud/captcha/token/recaptcha2", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.ACE_API_TOKEN}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify(data),
  });
  if (!response.ok) throw new Error(`API error: ${response.status}`);
  return response.json();
}

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

Поширені коди помилок:

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

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

Перейдіть до Ace Data Cloud Консолі для отримання API Token
Ознайомтеся з API документацією для повного опису параметрів
Перегляньте плани тарифікації для ознайомлення з вартістю

Tutorials

​Вступ

​Передумови

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

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

​Обгортка для Node.js

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

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