Il tuo codice.
Un nuovo flusso di lavoro.

Iniziare

L'integrazione prevede tre passaggi: identificare la tua applicazione, creare un'attività e seguirne il risultato. Esplora l'esperienza nella dashboard demo.

Autenticazione

La proposta utilizza una credenziale clientKey nelle chiamate al server. Conserva la chiave nelle variabili di ambiente, al di fuori del codice pubblico e del browser. Le chiavi della dashboard demo non possono accedere ai servizi.

Crea un'attività

Invia le credenziali e i parametri richiesti per il tipo selezionato.

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

Risposta prevista

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

Recupera il risultato

Usa il taskId per controllare lo stato. Se è in elaborazione, attendere prima di ricontrollare, rispettando gli intervalli e i limiti definiti dall'API.

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

Stati ed errori

Gestisci credenziali non valide, saldo insufficiente, risposte impreviste e timeout. I nomi degli errori finali verranno definiti dall'API.