Tu código.
Un nuevo flujo de trabajo.
Descubra la integración propuesta y prepare su aplicación para la API.
Comenzando
La integración tiene tres pasos: identificar su aplicación, crear una tarea y seguir su resultado. Explore la experiencia en el panel de demostración.
Autenticación
La propuesta utiliza una credencial clientKey en llamadas al servidor. Mantenga la clave en las variables de entorno, fuera del código público y del navegador. Las claves del panel de demostración no pueden acceder a los servicios.
Crear una tarea
POST /createTaskEnviar la credencial y los parámetros requeridos para el tipo seleccionado.
// Contrato proposto — configure a URL da API real no servidor
const response = await fetch(API_BASE_URL + "/createTask", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
clientKey: process.env.SOLUCAPTCHA_API_KEY,
task: {
type: "RecaptchaV2Task",
websiteURL: "https://sua-aplicacao.com",
websiteKey: "SUA_SITE_KEY"
}
})
});
if (!response.ok) throw new Error("Falha ao criar tarefa");
const task = await response.json();Respuesta esperada
{
"errorId": 0,
"taskId": "example-task-id"
}Recuperar el resultado
POST /getTaskResultUtilice el taskId para comprobar el estado. Si se está procesando, espere antes de volver a verificar, respetando los intervalos y límites definidos por la API.
{
"clientKey": "SUA_CHAVE_NO_SERVIDOR",
"taskId": "example-task-id"
}Estados y errores
La tarea tiene un resultado disponible.
La tarea aún se está procesando.
Verifique el código de error devuelto y la descripción.
Manejar credenciales no válidas, saldo insuficiente, respuestas inesperadas y tiempos de espera. Los nombres de los errores finales los definirá la API.