Seu código.
Um novo fluxo.

Primeiros passos

A integração está organizada em três etapas: identificar sua aplicação, criar uma tarefa e acompanhar seu resultado. Use o painel demonstrativo para conhecer a experiência.

Autenticação

A proposta usa uma credencial clientKey nas chamadas do servidor. A chave deve permanecer em variáveis de ambiente, fora do código público e do navegador. As chaves do painel demo não acessam serviços.

Criar uma tarefa

Envie a credencial e os parâmetros necessários para o tipo escolhido.

// 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();

Resposta esperada

{
  "errorId": 0,
  "taskId": "example-task-id"
}

Consultar o resultado

Use o taskId para consultar o estado. Se estiver em processamento, aguarde antes de consultar novamente, respeitando os intervalos e limites definidos pela API.

{
  "clientKey": "SUA_CHAVE_NO_SERVIDOR",
  "taskId": "example-task-id"
}

Estados e erros

Trate credenciais inválidas, saldo insuficiente, respostas inesperadas e tempo limite. A nomenclatura final dos erros será definida pela API.