API de CAPTCHA de EverySolve
API de Cloudflare Turnstile
La API de Cloudflare Turnstile de EverySolve devuelve un token para tu flujo de verificación. Envía POST /api/v1/captcha con type igual a turnstile y las entradas indicadas a continuación.
Cloudflare Turnstile es un widget gestionado, no interactivo o invisible con su propia clave. Devuelve token para cf-turnstile-response; la página de desafío de Cloudflare devuelve cookies.
- Endpoint
- POST /api/v1/captcha
- Tipo
- turnstile
- Por 1.000 resoluciones correctas
- $1.53 por 1.000 resoluciones correctas
Parámetros de la solicitud
Proporciona website_url y website_key. Los parámetros opcionales son action, cdata y page_data.
Parámetros obligatorios
website_urlwebsite_keyParámetros opcionales
actioncdatapage_datacurl -X POST https://api.everyinfra.com/api/v1/captcha \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"type":"turnstile","website_url":"<website_url>","website_key":"<website_key>"}'
Cómo reconocer Cloudflare Turnstile
Cloudflare Turnstile es un widget gestionado, no interactivo o invisible con su propia clave.
Qué distingue a Cloudflare Turnstile
Devuelve token para cf-turnstile-response; la página de desafío de Cloudflare devuelve cookies.
Origen de los parámetros de Cloudflare Turnstile
Copia website_key de data-sitekey o turnstile.render; action, cdata y page_data deben pertenecer a la misma instancia.
website_urlObligatorio- Página exacta donde aparece el reto, incluida la ruta pertinente y no solo la portada.
website_keyObligatorio- Clave pública del sitio o widget copiada de esta integración exacta; no es una clave secreta.
actionOpcional- Nombre de acción de esta instancia; cópialo de la integración objetivo.
cdataOpcional- Dato personalizado de la misma instancia del widget.
page_dataOpcional- Datos serializados asociados a esta instancia del widget.
¿Qué devuelve la API?
La API devuelve un token. Insértalo en el campo oculto cf-turnstile-response. Caduca a los 300 segundos y solo se puede usar una vez.
- Formato de solución
- token
- Campos de solución
token
Cómo usar la API de Cloudflare Turnstile
- 01Consulta GET /api/v1/captcha/types y selecciona la entrada
turnstile. - 02Envía
type: "turnstile"y los parámetros obligatorios a POST /api/v1/captcha. - 03Consulta un token en
token. - 04Inserta el token devuelto en el campo oculto
cf-turnstile-responsey envíalo dentro de sus 300 segundos de validez. Solo se puede usar una vez.
Facturación y disponibilidad
EverySolve descuenta el importe al aceptar la solicitud y lo devuelve automáticamente si la solución no se entrega correctamente. Consulta available y los campos de precio en GET /api/v1/captcha/types cuando vayas a enviar la solicitud; no son datos estáticos de la página.
Preguntas de integración de Cloudflare Turnstile
¿Cómo identifico Cloudflare Turnstile antes de elegir el tipo?
Cloudflare Turnstile es un widget gestionado, no interactivo o invisible con su propia clave. Usa turnstile solo cuando esas señales coincidan con el reto objetivo.
¿Qué valores de la página pertenecen a una solicitud de Cloudflare Turnstile?
Copia website_key de data-sitekey o turnstile.render; action, cdata y page_data deben pertenecer a la misma instancia. Proporciona website_url y website_key. Los parámetros opcionales son action, cdata y page_data.
¿Qué devuelve Cloudflare Turnstile y con qué no debe confundirse?
La API de Cloudflare Turnstile devuelve un token en token. Su formato de solución es token. Devuelve token para cf-turnstile-response; la página de desafío de Cloudflare devuelve cookies.
¿Qué fuente externa explica la integración de Cloudflare Turnstile?
Cloudflare documenta renderizado, modos, callbacks y manejo del token Turnstile. [Abrir la referencia de Cloudflare Turnstile](https://developers.cloudflare.com/turnstile/). Los campos específicos de EverySolve y la disponibilidad actual siguen procediendo del catálogo de tipos.