Przejdź do głównej treści

​
Wprowadzenie

hCaptcha to usługa CAPTCHA oferowana przez Ace Data Cloud, rozwiązanie hCaptcha. Dzięki zunifikowanemu API Ace Data Cloud możesz szybko zintegrować hCaptcha za pomocą JavaScript, realizując pobieranie tokenów hCaptcha, rozpoznawanie obrazów hCaptcha i inne funkcje.

​
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 hCaptcha to: 
POST https://api.acedata.cloud/captcha/token/hcaptcha
Pełny przykład kodu JavaScript: 
const response = await fetch("https://api.acedata.cloud/captcha/token/hcaptcha", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "website_key": "a5f74b19-9e45-40e0-b45d-47ff91b7a6c2",
  "website_url": "https://accounts.hcaptcha.com/demo"
}),
});

const result = await response.json();
console.log(result);
Proszę zamienić YOUR_API_TOKEN na rzeczywisty token uzyskany na platformie Ace Data Cloud.

​
Obsługa odpowiedzi

Zaleca się sprawdzenie statusu odpowiedzi i obsługę błędów: 
if (response.ok) {
  const result = await response.json();
  console.log("Wywołanie powiodło się:", 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

Rekomendowane jest opakowanie w funkcję wielokrotnego użytku: 
async function callhCaptcha(data) {
  const response = await fetch("https://api.acedata.cloud/captcha/token/hcaptcha", {
    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

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

​
Kolejne kroki