Por qué solvethree usa un perfil de sitio en lugar de un campo websiteKey

1. 1.

   Abre Añadir un sitio

   Ve a Perfiles de sitio y selecciona Añadir un sitio. Introduce la URL de página HTTPS del destino. La tarea usará su nombre de host, no esta URL completa. Proporciona la URL de navegación opcional y el valor de Referer si son necesarios para configurar la página.

2. 2.

   Elige el tipo y comprueba la clave del sitio

   Selecciona Enterprise v3 para una integración de reCAPTCHA Enterprise o Regular v3 para reCAPTCHA v3 estándar. El formulario puede detectar automáticamente la clave del sitio; puedes sustituirla por un valor en el campo opcional Clave del sitio.

3. 3.

   Establece la acción de captura

   La acción de captura es obligatoria. Para la solicitud siguiente, configura un perfil con la acción de captura login. Los perfiles de sistema revisados pueden completar la configuración conocida de la página y la acción de captura sin obtener los datos en tiempo real; lee la explicación del formulario sobre la acción elegida.

4. 4.

   Envía el perfil y espera a que esté activo

   Selecciona Añadir sitio. Los perfiles enviados pueden pasar por los estados en cola, capturando, validando o en revisión antes de activarse; no hay una duración de captura garantizada. Algunas cuentas muestran Añadir crédito para continuar. Si la captura falla, inspecciona el motivo antes de volver a intentarlo.

Usa un perfil por nombre de host, acción de captura y tipo de reCAPTCHA. Una coincidencia exacta de la acción de ejecución selecciona su perfil. Las demás acciones de ejecución requieren un único destino de captura inequívoco, así que no des por hecho que un solo perfil para un nombre de host cubre todas las acciones.

Una vez que el perfil esté activo, envía este objeto directamente como cuerpo JSON a POST /v1/tasks. Autentícate con Authorization: Bearer seguido de la clave de API de tu espacio de trabajo y mantén esa clave en el servidor.

{
  "site": "accounts.example.com",
  "action": "login",
  "proxy": "http://user:[email protected]:8080",
  "requestId": "example_login_001"
}

• site es el nombre de host: sin esquema, ruta ni consulta. La URL completa de la página debe ir en el perfil de la consola.
• action es la acción de ejecución de esta tarea. Aquí, login coincide con la acción de captura configurada anteriormente.
• proxy proporciona el proxy para la resolución. Se requiere exactamente uno de los campos proxy o proxyCandidates; no envíes ambos.
• requestId es opcional. Si se agota el tiempo de espera de la creación, reenviar la misma solicitud con el mismo ID devuelve la tarea existente. Cambiar los datos de entrada de la tarea reutilizando ese ID provoca un conflicto.

No conserves websiteKey, websiteURL, type ni url del formato de solicitud de la API anterior. Para reCAPTCHA, recaptchaType usa enterprise-v3 de forma predeterminada, por eso el ejemplo lo omite. Regular v3 usa recaptchaType con el valor v3.