Documentation

Tout ce qu'il vous faut pour intégrer et exploiter CaptchaCore. Si vous êtes pressé, le démarrage rapide et un coup d'œil à la réponse de verify suffisent.

Comment pouvons-nous aider ?

Je veux démarrer vite Créez un site, incluez le script, vérifiez le jeton. Cinq minutes, trois étapes. Prise en main → J'utilise WordPress, Laravel ou Symfony Installez et configurez l'extension ou le paquet prêt à l'emploi. Intégrations → Je développe ma propre extension L'ordre des étapes, les modèles et la liste de contrôle avant publication. Créer votre propre intégration → Je cherche un champ de réponse précis Tous les points d'accès, champs, codes de statut et limites en un coup d'œil. Référence de l'API →

Tous les chapitres

01Prise en main Créez un site, ajoutez le widget, vérifiez le jeton — le chemin le plus court vers une protection opérationnelle. Démarrage rapideIntégration HTML 02Intégrations Des paquets prêts à l’emploi pour Laravel, Symfony, WordPress et WoltLab Suite — et le guide pour créer le vôtre. Paquet LaravelBundle SymfonyExtension WordPressWoltLab SuiteCréer votre propre intégration 03Widget Tous les attributs, les trois modes et l'API JavaScript pour les formulaires chargés ultérieurement. Options du widgetModes du widgetAPI JavaScript 04Référence de l'API Points d'accès, champs de réponse, codes de statut, limites de débit et nos engagements de stabilité. Points d'accès et réponsesWebhooksVersionnement 05Détection Comment le moteur de risque évalue, comment profils et politiques s'appliquent, et ce qui se passe en cas d'attaque. Risk EngineProfils de site & policies de formulaireUnder-Attack-Mode 06Exploitation Comportement en cas de panne, rotation des clés, exemples serveur, domaines et politique de sécurité du contenu. Gestion des erreurs & fail-openClés et rotationExemples backendDomaines, CORS et CSP 07Aide et confidentialité Les écueils les plus fréquents et leur solution, ainsi que ce que CaptchaCore conserve sur vos visiteurs. DépannageProtection des données

L'essentiel en bref

1 · Inclure le widget

<script src="https://src-eu.captchacore.eu/widget/captchacore-v2.min.js"
        data-service-url="https://api.captchacore.eu"
        data-site-key="cc_pub_…" async defer></script>

<form data-captchacore="interactive" method="post">
    <div data-captchacore-widget></div>
</form>

2 · Vérifier le jeton

POST https://api.captchacore.eu/api/v2/verify
X-CaptchaCore-Key: cc_sec_…

{ "token": "…", "form_type": "contact" }

Réponse

{ "valid": true, "decision": "allow", "risk_score": 8, "confidence": 0.94 } Traitez le formulaire normalement.

{ "valid": true, "decision": "challenge", "risk_score": 41, "confidence": 0.71 } Laissez passer mais journalisez. Ajoutez éventuellement une vérification à vous, par exemple un e-mail de confirmation.

{ "valid": false, "decision": "step_up", "risk_score": 58, "step_up": { … } } Ne refusez PAS d'emblée. Le widget effectue lui-même la vérification supplémentaire ; rendez le formulaire à l'utilisateur avec un message aimable.

{ "valid": false, "decision": "block", "risk_score": 96, "confidence": 0.88 } Refusez. Affichez une erreur sans détail afin que les attaquants n'apprennent rien.

valid vaut aussi false pour step_up. Ne traitez pas step_up comme block — détails.