API reCAPTCHA v3 Enterprise 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 Enterprise di EverySolve restituisce un token per il tuo flusso di gestione delle challenge.reCAPTCHA v3 Enterprise usa una chiave Enterprise basata su punteggio con enterprise.js e grecaptcha.enterprise.execute. Restituisce gRecaptchaResponse per la valutazione Enterprise. Non ha la checkbox v2 e non è la v3 classica con api.js solo perché entrambe sono invisibili.

Invia POST https://api.everyinfra.com/api/v1/captcha con type impostato su recaptcha_v3_enterprise. Inserisci i parametri nel corpo della richiesta, allo stesso livello di type. $3.06 per 1.000 risoluzioni riuscite ($0.003056 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 Enterprise» 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_enterprise 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.
  - enterprise_payload: I dati di pagina specifici di Enterprise forniti dall'integrazione reCAPTCHA di destinazione, se presenti.
  - 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_v3_enterprise",
  "website_url": "<website_url>",
  "website_key": "<website_key>"
}
- Addebito: $3.06 per 1.000 risoluzioni riuscite ($0.003056 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_enterprise`	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.
`enterprise_payload`	body	`object`	No	-	I dati di pagina specifici di Enterprise forniti dall'integrazione reCAPTCHA di destinazione, se presenti.
`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`

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_enterprise",
  "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_enterprise",  "solution": {    "gRecaptchaResponse": "…"  },  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

Da dove provengono i parametri di reCAPTCHA v3 Enterprise

Copia la chiave Enterprise e l'azione dalla chiamata di destinazione; enterprise_payload e api_domain si applicano solo quando quell'integrazione li espone.

Codice per trovare questi valori nella pagina

recaptcha_v3_enterprise-1.html

<script src="https://www.google.com/recaptcha/enterprise.js?render=<sitekey>"></script>

recaptcha_v3_enterprise-2.js

grecaptcha.enterprise.ready(async () => {
  const token = await grecaptcha.enterprise.execute('<sitekey>', {action: 'LOGIN'});
});

recaptcha_v3_enterprise-3.js

const _x = grecaptcha.enterprise.execute;
grecaptcha.enterprise.execute = (k, o) => { console.log(k, o); return _x(k, o); };

Come riconoscere reCAPTCHA v3 Enterprise

reCAPTCHA v3 Enterprise usa una chiave Enterprise basata su punteggio con enterprise.js e grecaptcha.enterprise.execute.

Cosa distingue reCAPTCHA v3 Enterprise

Restituisce gRecaptchaResponse per la valutazione Enterprise. Non ha la checkbox v2 e non è la v3 classica con api.js solo perché entrambe sono invisibili.

Come usare l'API reCAPTCHA v3 Enterprise

L'API reCAPTCHA v3 Enterprise 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_enterprise.
02Nella richiesta POST /api/v1/captcha, invia type: "recaptcha_v3_enterprise" 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 Enterprise

Come riconosco reCAPTCHA v3 Enterprise prima di scegliere un tipo?

reCAPTCHA v3 Enterprise usa una chiave Enterprise basata su punteggio con enterprise.js e grecaptcha.enterprise.execute. Usa recaptcha_v3_enterprise 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 Enterprise?

Copia la chiave Enterprise e l'azione dalla chiamata di destinazione; enterprise_payload e api_domain si applicano solo quando quell'integrazione li espone. Fornisci website_url e website_key. I parametri facoltativi sono page_action, enterprise_payload e api_domain.

Cosa restituisce reCAPTCHA v3 Enterprise e con cosa non va confuso?

L'API reCAPTCHA v3 Enterprise restituisce un token in gRecaptchaResponse. Il formato della soluzione è token. Restituisce gRecaptchaResponse per la valutazione Enterprise. Non ha la checkbox v2 e non è la v3 classica con api.js solo perché entrambe sono invisibili.

Quale fonte esterna spiega l'integrazione di reCAPTCHA v3 Enterprise?

Google Cloud documenta le chiavi Enterprise basate su punteggio, le azioni e la valutazione dei token. [Apri il riferimento per reCAPTCHA v3 Enterprise](https://docs.cloud.google.com/recaptcha/docs/instrument-web-pages). I campi specifici di EverySolve e la disponibilità in tempo reale restano comunque quelli del catalogo dei tipi.

Riferimento per reCAPTCHA v3 Enterprise

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