Passer au contenu principal

​
Présentation

hCaptcha est un service de captcha fourni par Ace Data Cloud. La solution hCaptcha permet, via l’API unifiée d’Ace Data Cloud, d’intégrer rapidement hCaptcha en JavaScript pour obtenir un Token hCaptcha, réaliser la reconnaissance d’images hCaptcha, et d’autres fonctionnalités.

​
Prérequis

  • Posséder un compte Ace Data Cloud et obtenir un API Token
  • Environnement Node.js 18+ ou navigateur moderne

​
Utilisation de base

Le point d’entrée principal pour appeler l’API hCaptcha est : 
POST https://api.acedata.cloud/captcha/token/hcaptcha
Exemple complet de code 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);
Veuillez remplacer YOUR_API_TOKEN par le Token réel obtenu sur la plateforme Ace Data Cloud.

​
Gestion de la réponse

Il est recommandé de vérifier le code de statut de la réponse et de gérer les erreurs : 
if (response.ok) {
  const result = await response.json();
  console.log("Appel réussi :", result);
} else {
  console.error(`Échec de l'appel, code de statut : ${response.status}`);
  const error = await response.text();
  console.error(error);
}

​
Encapsulation Node.js

Il est conseillé d’encapsuler dans une fonction réutilisable : 
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(`Erreur API : ${response.status}`);
  return response.json();
}

​
Gestion des erreurs

Codes d’erreur courants :
Code de statutDescription
401Échec d’authentification, vérifiez l’API Token
403Solde insuffisant ou accès refusé
429Limite de fréquence dépassée
500Erreur interne du serveur

​
Étapes suivantes