API reCAPTCHA v3 solver

POST

Stato di salute dell'API

Operatività nelle ultime 24 ore: Normale

Buono / normale
Disponibile
Limitato
Quasi del tutto inattivo

Ultime 24 ore

Ultimi 30 giorni

L'API reCAPTCHA v3 di EverySolve restituisce un token per il tuo flusso di gestione delle challenge.reCAPTCHA v3 si basa su un punteggio e di norma viene eseguito tramite grecaptcha.execute senza mostrare la checkbox v2. EverySolve restituisce gRecaptchaResponse, non il punteggio di valutazione di Google. È il backend del sito protetto a valutare il token e l'azione.

Invia POST https://api.everyinfra.com/api/v1/captcha con type impostato su recaptcha_v3. Inserisci i parametri nel corpo della richiesta, allo stesso livello di type. $1.39 per 1.000 risoluzioni riuscite ($0.001389 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 v3» 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_v3 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:
  - page_action: La stringa dell'azione usata dall'esecuzione reCAPTCHA di destinazione; rispettane esattamente maiuscole, minuscole e grafia.
  - min_score: La soglia di punteggio reCAPTCHA v3 richiesta; è un vincolo, non un punteggio o un tasso di successo garantito. (valori consentiti: 0.3 / 0.7 / 0.9)
  - api_domain: L'hostname dell'API usato dal widget di destinazione quando è diverso dal dominio standard. (valori consentiti: www.google.com / www.recaptcha.net)
  - invisible: Indica se il widget di destinazione usa la modalità invisibile; non dedurlo solo dall'assenza di un'immagine.
  - enterprise_payload: I dati di pagina specifici di Enterprise forniti dall'integrazione reCAPTCHA di destinazione, se presenti.
- Esempio di corpo della richiesta:
{
  "type": "recaptcha_v3",
  "website_url": "<website_url>",
  "website_key": "<website_key>"
}
- Addebito: $1.39 per 1.000 risoluzioni riuscite ($0.001389 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

Nome	Posizione	Tipo	Obbligatorio	Predefinito	Descrizione
`Authorization`	header	`string`	Sì	-	Bearer seguito dalla tua chiave API. Creala nella console; non inserirla mai in un URL o in un repository di codice.
`type`	body	`string`	Sì	`recaptcha_v3`	Tipo di CAPTCHA, valore fisso.
`website_url`	body	`string`	Sì	-	La pagina esatta in cui compare questa challenge, incluso il percorso pertinente e non solo la home page del sito.
`website_key`	body	`string`	Sì	-	La chiave pubblica del sito o del widget copiata da questa esatta integrazione di destinazione; non è una chiave segreta.
`page_action`	body	`string`	No	-	La stringa dell'azione usata dall'esecuzione reCAPTCHA di destinazione; rispettane esattamente maiuscole, minuscole e grafia.
`min_score`	body	`number (enum)`	No	-	La soglia di punteggio reCAPTCHA v3 richiesta; è un vincolo, non un punteggio o un tasso di successo garantito.Valori consentiti`0.30.70.9`
`api_domain`	body	`string (enum)`	No	-	L'hostname dell'API usato dal widget di destinazione quando è diverso dal dominio standard.Valori consentiti`www.google.comwww.recaptcha.net`
`invisible`	body	`boolean`	No	-	Indica se il widget di destinazione usa la modalità invisibile; non dedurlo solo dall'assenza di un'immagine.
`enterprise_payload`	body	`object`	No	-	I dati di pagina specifici di Enterprise forniti dall'integrazione reCAPTCHA di destinazione, se presenti.

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_v3",
  "website_url": "<website_url>",
  "website_key": "<website_key>"
}'

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

json

{  "id": "req_…",  "type": "recaptcha_v3",  "solution": {    "gRecaptchaResponse": "…"  },  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

Da dove provengono i parametri di reCAPTCHA v3

Copia website_key dal valore render di api.js e conserva esattamente page_action; min_score è un vincolo della richiesta, non un punteggio garantito dal sito di destinazione.

Codice per trovare questi valori nella pagina

recaptcha_v3-1.js

grecaptcha.ready(function () {
  grecaptcha.execute('<sitekey>', {action: 'submit'}).then(function (token) { … });
});

recaptcha_v3-2.js

const _x = grecaptcha.execute;
grecaptcha.execute = (k, o) => { console.log('sitekey:', k, 'opts:', o); return _x(k, o); };

Come riconoscere reCAPTCHA v3

reCAPTCHA v3 si basa su un punteggio e di norma viene eseguito tramite grecaptcha.execute senza mostrare la checkbox v2.

Cosa distingue reCAPTCHA v3

EverySolve restituisce gRecaptchaResponse, non il punteggio di valutazione di Google. È il backend del sito protetto a valutare il token e l'azione.

Come usare l'API reCAPTCHA v3

L'API reCAPTCHA v3 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.

01Esegui GET /api/v1/captcha/types e seleziona la voce recaptcha_v3.
02Nella richiesta POST /api/v1/captcha, invia type: "recaptcha_v3" e i parametri obbligatori.
03Leggi un token da gRecaptchaResponse.
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 v3

Come riconosco reCAPTCHA v3 prima di scegliere un tipo?

reCAPTCHA v3 si basa su un punteggio e di norma viene eseguito tramite grecaptcha.execute senza mostrare la checkbox v2. Usa recaptcha_v3 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 v3?

Copia website_key dal valore render di api.js e conserva esattamente page_action; min_score è un vincolo della richiesta, non un punteggio garantito dal sito di destinazione. Fornisci website_url e website_key. I parametri facoltativi sono page_action, min_score, api_domain, invisible e enterprise_payload.

Cosa restituisce reCAPTCHA v3 e con cosa non va confuso?

L'API reCAPTCHA v3 restituisce un token in gRecaptchaResponse. Il formato della soluzione è token. EverySolve restituisce gRecaptchaResponse, non il punteggio di valutazione di Google. È il backend del sito protetto a valutare il token e l'azione.

Quale fonte esterna spiega l'integrazione di reCAPTCHA v3?

Google documenta l'esecuzione di v3, i nomi delle azioni, i token e la valutazione basata su punteggio. [Apri il riferimento per reCAPTCHA v3](https://developers.google.com/recaptcha/docs/v3). I campi specifici di EverySolve e la disponibilità in tempo reale restano comunque quelli del catalogo dei tipi.

Riferimento per reCAPTCHA v3

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