Configura un perfil de sitio de reCAPTCHA
Configura el sitio en Perfiles de sitio y espera a que su perfil muestre active antes de solicitar un token. Enviar un nombre de host y una acción a la API de tareas no crea un perfil.
En esta página
Añade el sitio en la consola
- 1.
Comprueba el espacio de trabajo
Configura el perfil en el espacio de trabajo cuya clave de API usarás para crear tareas. No basta con tener un perfil en otro espacio de trabajo. Si la consola muestra Añadir saldo para continuar, sigue esa indicación antes de continuar con la configuración.
- 2.
Abre Añadir un sitio
En Perfiles de sitio, selecciona Añadir un sitio. Introduce la página HTTPS de destino en URL de la página. En Tipo de reCAPTCHA, elige Enterprise v3 o Regular v3 según corresponda a la página.
- 3.
Configura los datos de captura
La acción de captura es obligatoria. Usa la acción para la que quieres resolver; si no estás seguro, primero busca la acción de reCAPTCHA. El formulario también incluye los campos opcionales URL de navegación, Clave del sitio y Valor de Referer. La clave del sitio se puede detectar automáticamente.
- 4.
Envía el formulario
Selecciona Añadir sitio. Los perfiles del sistema revisados pueden rellenar el contrato conocido de la página y la acción de captura sin realizar una obtención en vivo; el formulario explica la acción elegida. Las demás solicitudes pueden pasar a los estados en cola, capturando, validando o en revisión.
Comprueba el estado del perfil resultante. ACTIVE se muestra como active, y ese es el estado necesario para resolver. Si la captura falla, la consola muestra un motivo y permite reintentar.
Solicita un token con el perfil activo
Este cuerpo de tarea usa el nombre de host y la acción del perfil:
{
"site": "accounts.example.com",
"action": "login",
"proxy": "http://user:[email protected]:8080",
"requestId": "example_login_001"
}sitees el nombre de host de URL de la página, sin esquema ni ruta.actiones la acción de la solicitud protegida. Haz que coincida con el perfil que quieres usar.- El valor predeterminado de
recaptchaTypeesenterprise-v3. Para un perfil Regular v3, establécelo explícitamente env3. - Sustituye el marcador de posición del proxy por el proxy HTTP(S) que también usarás para la solicitud de destino.
Las guías de inicio rápido de Python e inicio rápido de Node.js muestran cómo enviar la solicitud y usar el resultado.
Corrige un perfil ausente o inactivo
- No hay ningún perfil disponible para la tarea.
Compara el espacio de trabajo asociado a tu clave de API y el nombre de host de la tarea con el perfil que configuraste.
Prueba esto: Añade el perfil de sitio previsto en el espacio de trabajo que creará la tarea. Repetir la creación de la tarea no creará el perfil que falta.
- El perfil está en cola, capturando, validando o en revisión.
Consulta su estado actual en Perfiles de sitio.
Prueba esto: Espera a que el perfil esté activo antes de solicitar una resolución. Estos estados no sustituyen a un perfil activo.
- La captura ha fallado.
Consulta el motivo del fallo que aparece en la consola.
Prueba esto: Corrige el problema indicado por ese motivo y vuelve a intentar la captura.
- Hay un perfil activo, pero la acción prevista sigue sin resolverse.
Compara el nombre de host, la acción de captura y el tipo de reCAPTCHA. Si la acción de ejecución es diferente, comprueba si hay un único destino de captura inequívoco.
Prueba esto: Configura un perfil que coincida con el nombre de host, la acción y el tipo previstos, en lugar de cambiar la tarea a una acción no relacionada solo para seleccionar un perfil existente.
Fuentes y referencia de la API
Ejecuta tu primera tarea.
Empieza con $5 de crédito en tu espacio de trabajo.