Przejdź do głównej treści

​
Wprowadzenie

reCAPTCHA to usługa CAPTCHA oferowana przez Ace Data Cloud, rozwiązanie Google reCAPTCHA. Dzięki zunifikowanemu API Ace Data Cloud możesz szybko zintegrować reCAPTCHA za pomocą JavaScript, realizując funkcje takie jak Token reCAPTCHA v2, rozpoznawanie reCAPTCHA v2, Token reCAPTCHA v3 i inne.

​
Wymagania wstępne

  • Konto w Ace Data Cloud oraz uzyskany API Token
  • Node.js 18+ lub nowoczesne środowisko przeglądarki

​
Podstawowe użycie

Główny endpoint API reCAPTCHA to: 
POST https://api.acedata.cloud/captcha/token/recaptcha2
Pełny przykład kodu 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);
Proszę zastąpić YOUR_API_TOKEN rzeczywistym tokenem uzyskanym na platformie Ace Data Cloud.

​
Obsługa odpowiedzi

Zaleca się sprawdzanie statusu odpowiedzi i obsługę błędów: 
if (response.ok) {
  const result = await response.json();
  console.log("Wywołanie zakończone sukcesem:", result);
} else {
  console.error(`Wywołanie nie powiodło się, kod statusu: ${response.status}`);
  const error = await response.text();
  console.error(error);
}

​
Opakowanie w Node.js

Zaleca się opakowanie w funkcję wielokrotnego użytku: 
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(`Błąd API: ${response.status}`);
  return response.json();
}

​
Obsługa błędów

Najczęstsze kody błędów:
Kod statusuOpis
401Nieautoryzowany, sprawdź API Token
403Niewystarczające środki lub brak dostępu
429Przekroczona częstotliwość żądań
500Błąd wewnętrzny serwera

​
Kolejne kroki