POST

Stato di salute dell'API

Operatività nelle ultime 24 ore
Normale
  • Buono / normale
  • Disponibile
  • Limitato
  • Quasi del tutto inattivo
Normale

Ultime 24 ore

Ultimi 30 giorni

L'API reCAPTCHA v2 di EverySolve restituisce un token per il tuo flusso di gestione delle challenge.reCAPTCHA v2 è il classico widget v2 con checkbox o invisibile, caricato tramite api.js e configurato con una site key. Restituisce gRecaptchaResponse per il modulo di destinazione. v3 si basa su un punteggio, mentre Enterprise carica enterprise.js con un contesto specifico di Enterprise.

Invia POST https://api.everyinfra.com/api/v1/captcha con type impostato su recaptcha_v2. Inserisci i parametri nel corpo della richiesta, allo stesso livello di type. $1.11 per 1.000 risoluzioni riuscite ($0.001111 per risoluzione riuscita). Le chiamate non riuscite e i risultati vuoti non vengono addebitati.

Prompt per l'AI

#
Aiutami a scrivere uno script che chiami l'API «reCAPTCHA v2» di EveryInfra.

Contratto dell'API:
- Richiesta: POST https://api.everyinfra.com/api/v1/captcha con l'header Authorization: Bearer <API Key>. Leggi la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY; non inserirla nel codice.
- Nel corpo della richiesta, imposta type su recaptcha_v2 e inserisci i parametri accanto, allo stesso livello.
- Parametri obbligatori:
  - website_url: La pagina esatta in cui compare questa challenge, incluso il percorso pertinente e non solo la home page del sito.
  - website_key: La chiave pubblica del sito o del widget copiata da questa esatta integrazione di destinazione; non è una chiave segreta.
- Parametri facoltativi:
  - invisible: Indica se il widget di destinazione usa la modalità invisibile; non dedurlo solo dall'assenza di un'immagine.
  - data_s: Il valore data-s esposto da un'integrazione reCAPTCHA v2, quando quell'implementazione lo usa.
  - page_action: La stringa dell'azione usata dall'esecuzione reCAPTCHA di destinazione; rispettane esattamente maiuscole, minuscole e grafia.
  - api_domain: L'hostname dell'API usato dal widget di destinazione quando è diverso dal dominio standard. (valori consentiti: www.google.com / www.recaptcha.net)
- Esempio di corpo della richiesta:
{
  "type": "recaptcha_v2",
  "website_url": "https://www.google.com/recaptcha/api2/demo",
  "website_key": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-"
}
- Addebito: $1.11 per 1.000 risoluzioni riuscite ($0.001111 per risoluzione riuscita). Le chiamate non riuscite e i risultati vuoti non vengono addebitati.
- In caso di 422, correggi i parametri seguendo i suggerimenti e i valori consentiti indicati nell'errore. In caso di 429 o 503, attendi il tempo indicato in Retry-After e riprova.

Prima di scrivere il codice, chiedimi quanti elementi devo elaborare e in quale formato salvare i risultati, poi conferma con me il piano e il costo indicativo.

Parametri della richiesta

#
NomePosizioneTipoObbligatorioPredefinitoDescrizione
AuthorizationheaderstringSì-Bearer seguito dalla tua chiave API. Creala nella console; non inserirla mai in un URL o in un repository di codice.
typebodystringSìrecaptcha_v2Tipo di CAPTCHA, valore fisso.
website_urlbodystringSì-La pagina esatta in cui compare questa challenge, incluso il percorso pertinente e non solo la home page del sito.
website_keybodystringSì-La chiave pubblica del sito o del widget copiata da questa esatta integrazione di destinazione; non è una chiave segreta.
invisiblebodybooleanNo-Indica se il widget di destinazione usa la modalità invisibile; non dedurlo solo dall'assenza di un'immagine.
data_sbodystringNo-Il valore data-s esposto da un'integrazione reCAPTCHA v2, quando quell'implementazione lo usa.
page_actionbodystringNo-La stringa dell'azione usata dall'esecuzione reCAPTCHA di destinazione; rispettane esattamente maiuscole, minuscole e grafia.
api_domainbodystring (enum)No-L'hostname dell'API usato dal widget di destinazione quando è diverso dal dominio standard.Valori consentitiwww.google.comwww.recaptcha.net

Esempi di codice

#
bash
curl -X POST 'https://api.everyinfra.com/api/v1/captcha' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "type": "recaptcha_v2",
  "website_url": "https://www.google.com/recaptcha/api2/demo",
  "website_key": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-"
}'

Definizione OpenAPI (JSON)Gli esempi leggono la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY; il codice copiato non contiene mai la tua chiave.

Esempio di risposta

#
Acquisito il October 24, 2026 at 22:38 (UTC) chiamando questa API con i parametri dell'esempio di codice qui sopra. token e solution sono la risposta reale di quella chiamata. id, billing e quota cambiano a ogni chiamata, quindi ne viene mostrata solo la struttura.
json
{  "id": "req_…",  "type": "recaptcha_v2",  "token": "0cAFcWeA7Rd5wv7e9bepF8irY4Nt34xis_Z2Odugx9vwI8EJaB0jsbNpD-1yWTjoq0UkbktWz-_aspPkwtcI5tHOUImrdjAs8UyXvoEm1fV8lMYjH7NLvRhk0cODJN1LBQax5TCIKxaUo4QCWd5uv6KyLQeKVvBqc63gfsJUrpPxOvR7SwgBRwX4BjeINjZoWmyx0rEE4cDLXtsYoEALwNLVOj3EB5w8vDKSFlUaC3HIVV5LCj7mX-9J2ydklexJSGSXGKf_35j9ESCHownOdjM1…",  "solution": {    "gRecaptchaResponse": "0cAFcWeA7Rd5wv7e9bepF8irY4Nt34xis_Z2Odugx9vwI8EJaB0jsbNpD-1yWTjoq0UkbktWz-_aspPkwtcI5tHOUImrdjAs8UyXvoEm1fV8lMYjH7NLvRhk0cODJN1LBQax5TCIKxaUo4QCWd5uv6KyLQeKVvBqc63gfsJUrpPxOvR7SwgBRwX4BjeINjZoWmyx0rEE4cDLXtsYoEALwNLVOj3EB5w8vDKSFlUaC3HIVV5LCj7mX-9J2ydklexJSGSXGKf_35j9ESCHownOdjM1…"  },  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

Da dove provengono i parametri di reCAPTCHA v2

#

Copia website_key da data-sitekey o dalla chiamata di render; invisible, data_s, page_action e api_domain sono facoltativi e vanno inviati solo se presenti in quell'integrazione v2.

Codice per trovare questi valori nella pagina

recaptcha_v2-1.html
<div class="g-recaptcha" data-sitekey="your_site_key"></div>

Come riconoscere reCAPTCHA v2

#

reCAPTCHA v2 è il classico widget v2 con checkbox o invisibile, caricato tramite api.js e configurato con una site key.

Cosa distingue reCAPTCHA v2

Restituisce gRecaptchaResponse per il modulo di destinazione. v3 si basa su un punteggio, mentre Enterprise carica enterprise.js con un contesto specifico di Enterprise.

Come usare l'API reCAPTCHA v2

#

L'API reCAPTCHA v2 restituisce un token in gRecaptchaResponse. Il formato della soluzione è token. Invia il token nel campo o nella richiesta di verifica previsti dal flusso di destinazione.

  1. 01Esegui GET /api/v1/captcha/types e seleziona la voce recaptcha_v2.
  2. 02Nella richiesta POST /api/v1/captcha, invia type: "recaptcha_v2" e i parametri obbligatori.
  3. 03Leggi un token da gRecaptchaResponse.
  4. 04Invia il token nel campo o nella richiesta di verifica previsti dal flusso di destinazione.

Addebiti e disponibilità EverySolve addebita solo quando una soluzione viene consegnata con successo. Un tentativo non riuscito non comporta alcun addebito definitivo e l'importo eventualmente riservato viene ripristinato automaticamente. Recupera available e i campi dei prezzi dalla risposta di GET /api/v1/captcha/types al momento della richiesta, invece di considerarli contenuti statici della pagina.

Domande sull'integrazione di reCAPTCHA v2

#

Come riconosco reCAPTCHA v2 prima di scegliere un tipo?

reCAPTCHA v2 è il classico widget v2 con checkbox o invisibile, caricato tramite api.js e configurato con una site key. Usa recaptcha_v2 solo dopo aver verificato che questi segnali corrispondono alla challenge della pagina di destinazione.

Quali valori della pagina di destinazione vanno inseriti in una richiesta reCAPTCHA v2?

Copia website_key da data-sitekey o dalla chiamata di render; invisible, data_s, page_action e api_domain sono facoltativi e vanno inviati solo se presenti in quell'integrazione v2. Fornisci website_url e website_key. I parametri facoltativi sono invisible, data_s, page_action e api_domain.

Cosa restituisce reCAPTCHA v2 e con cosa non va confuso?

L'API reCAPTCHA v2 restituisce un token in gRecaptchaResponse. Il formato della soluzione è token. Restituisce gRecaptchaResponse per il modulo di destinazione. v3 si basa su un punteggio, mentre Enterprise carica enterprise.js con un contesto specifico di Enterprise.

Quale fonte esterna spiega l'integrazione di reCAPTCHA v2?

Google documenta il rendering dei widget v2 con checkbox e di quelli invisibili. [Apri il riferimento per reCAPTCHA v2](https://developers.google.com/recaptcha/docs/display). I campi specifici di EverySolve e la disponibilità in tempo reale restano comunque quelli del catalogo dei tipi.

Riferimento per reCAPTCHA v2

#
#

Tutti i tipi di CAPTCHA

Errori e addebiti

#
401
Chiave mancante o non valida.
402
Saldo insufficiente. Effettua prima una ricarica.
422
Nome o valore del parametro non valido. Correggilo seguendo i suggerimenti dell'errore. Nessun addebito.
429
Raggiunto il limite di richieste al minuto. Attendi il tempo indicato da Retry-After, poi riprova.
503
Impossibile completare. L'importo trattenuto torna sul tuo saldo. Se l'esito è incerto, verificalo prima di riprovare.
Risposta 200 vuota
Nessun dato. Nessun addebito.

Errori

Le nostre statistiche di visita interne sono sempre attive. Google Analytics viene caricato solo se scegli «Consenti analisi». Informativa sulla privacy