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 wywołać hCaptcha za pomocą cURL, realizując funkcje takie jak pobieranie tokena hCaptcha czy rozpoznawanie obrazów hCaptcha.

​
Wymagania wstępne

  • Posiadanie konta w Ace Data Cloud oraz uzyskanie tokena API
  • Środowisko terminalowe z zainstalowanym cURL

​
Podstawowe użycie

Główny endpoint API hCaptcha to: 
POST https://api.acedata.cloud/captcha/token/hcaptcha
Przykład pełnej komendy 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"}'
Proszę zastąpić YOUR_API_TOKEN rzeczywistym tokenem uzyskanym na platformie Ace Data Cloud.

​
Przykład odpowiedzi

Po pomyślnym wywołaniu zwracane są dane w formacie JSON, na przykład: 
{
  "status": "success",
  "data": {
    ...
  }
}

​
Przetwarzanie odpowiedzi za pomocą jq

Zaleca się użycie narzędzia jq do formatowania wyjścia: 
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 .

​
Obsługa błędów

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

​
Kolejne kroki