Documentación

Todo lo que necesita para integrar y operar CaptchaCore. Si tiene prisa, bastan el inicio rápido y un vistazo a la respuesta de verify.

¿En qué podemos ayudarle?

Quiero empezar rápido Cree un sitio, incluya el script, compruebe el token. Cinco minutos, tres pasos. Primeros pasos → Uso WordPress, Laravel o Symfony Instale y configure el complemento o paquete listo para usar. Integraciones → Estoy creando mi propio complemento El orden de trabajo, las plantillas y la lista de comprobación antes de publicar. Crear una integración propia → Busco un campo de respuesta concreto Todos los endpoints, campos, códigos de estado y límites de un vistazo. Referencia de la API →

Todos los capítulos

01Primeros pasos Cree un sitio, añada el widget, compruebe el token: el camino más corto a una protección funcional. Inicio rápidoIntegración HTML 02Integraciones Paquetes listos para Laravel, Symfony, WordPress y WoltLab Suite, y la guía para crear el suyo propio. Paquete de LaravelBundle de SymfonyComplemento de WordPressWoltLab SuiteCrear una integración propia 03Widget Todos los atributos, los tres modos y la API JavaScript para formularios cargados después. Opciones del widgetModos del widgetAPI JavaScript 04Referencia de la API Endpoints, campos de respuesta, códigos de estado, límites y nuestros compromisos de estabilidad. Endpoints y respuestasWebhooksVersionado 05Detección Cómo puntúa el motor de riesgo, cómo se aplican perfiles y políticas y qué ocurre bajo ataque. Risk EnginePerfiles de sitio y políticas de formularioUnder-Attack-Mode 06Operación Comportamiento ante caídas, rotación de claves, ejemplos de servidor, dominios y política de seguridad de contenidos. Gestión de errores y fail-openClaves y rotaciónEjemplos de backendDominios, CORS y CSP 07Ayuda y privacidad Los tropiezos más frecuentes con su solución y qué almacena CaptchaCore sobre sus visitantes. Solución de problemasPrivacidad

Lo esencial en breve

1 · Incluir el 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 · Comprobar el token

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

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

Respuesta

{ "valid": true, "decision": "allow", "risk_score": 8, "confidence": 0.94 } Procese el formulario con normalidad.

{ "valid": true, "decision": "challenge", "risk_score": 41, "confidence": 0.71 } Déjelo pasar pero regístrelo. Opcionalmente añada una comprobación propia, como un correo de confirmación.

{ "valid": false, "decision": "step_up", "risk_score": 58, "step_up": { … } } NO rechace de plano. El widget realiza la comprobación adicional por sí mismo; devuelva el formulario al usuario con un mensaje amable.

{ "valid": false, "decision": "block", "risk_score": 96, "confidence": 0.88 } Rechace. Muestre un error sin detalles para que los atacantes no aprendan nada.

valid también es false en step_up. No trate step_up como block: detalles.