API reCAPTCHA v2 Enterprise solver

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 Enterprise di EverySolve restituisce un token per il tuo flusso di gestione delle challenge.reCAPTCHA v2 Enterprise è una chiave Enterprise con checkbox o basata su policy, caricata tramite enterprise.js e grecaptcha.enterprise. Restituisce comunque gRecaptchaResponse, ma gli identificatori e i payload Enterprise non vanno mescolati con i valori api.js della v2 classica né con le chiavi v3 basate su punteggio.

Invia POST https://api.everyinfra.com/api/v1/captcha con type impostato su recaptcha_v2_enterprise. Inserisci i parametri nel corpo della richiesta, allo stesso livello di type. $1.53 per 1.000 risoluzioni riuscite ($0.001528 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 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_v2_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:
  - enterprise_payload: I dati di pagina specifici di Enterprise forniti dall'integrazione reCAPTCHA di destinazione, se presenti.
  - page_action: La stringa dell'azione usata dall'esecuzione reCAPTCHA di destinazione; rispettane esattamente maiuscole, minuscole e grafia.
  - invisible: Indica se il widget di destinazione usa la modalità invisibile; non dedurlo solo dall'assenza di un'immagine.
  - 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_enterprise",
  "website_url": "<website_url>",
  "website_key": "<website_key>"
}
- Addebito: $1.53 per 1.000 risoluzioni riuscite ($0.001528 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_v2_enterpriseTipo 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.
enterprise_payloadbodyobjectNo-I dati di pagina specifici di Enterprise forniti dall'integrazione reCAPTCHA di destinazione, se presenti.
page_actionbodystringNo-La stringa dell'azione usata dall'esecuzione reCAPTCHA di destinazione; rispettane esattamente maiuscole, minuscole e grafia.
invisiblebodybooleanNo-Indica se il widget di destinazione usa la modalità invisibile; non dedurlo solo dall'assenza di un'immagine.
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_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

#
Non è ancora disponibile una risposta di esempio per questi parametri. Questa anteprima mostra la struttura e i campi della risposta secondo la definizione dell'API, con … come segnaposto; non è il risultato di una chiamata reale.
json
{  "id": "req_…",  "type": "recaptcha_v2_enterprise",  "solution": {    "gRecaptchaResponse": "…"  },  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

Da dove provengono i parametri di reCAPTCHA v2 Enterprise

#

Copia la chiave Enterprise da data-sitekey o da grecaptcha.enterprise.render; conserva page_action ed enterprise_payload solo se l'integrazione di destinazione li fornisce.

Codice per trovare questi valori nella pagina

recaptcha_v2_enterprise-1.js
   grecaptcha.enterprise.render('html_element', {
     'sitekey': '<sitekey>',
     'action': 'LOGIN',
     'theme': 'light',
     'callback': verifyCallback
   });
   

Come riconoscere reCAPTCHA v2 Enterprise

#

reCAPTCHA v2 Enterprise è una chiave Enterprise con checkbox o basata su policy, caricata tramite enterprise.js e grecaptcha.enterprise.

Cosa distingue reCAPTCHA v2 Enterprise

Restituisce comunque gRecaptchaResponse, ma gli identificatori e i payload Enterprise non vanno mescolati con i valori api.js della v2 classica né con le chiavi v3 basate su punteggio.

Come usare l'API reCAPTCHA v2 Enterprise

#

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

  1. 01Esegui GET /api/v1/captcha/types e seleziona la voce recaptcha_v2_enterprise.
  2. 02Nella richiesta POST /api/v1/captcha, invia type: "recaptcha_v2_enterprise" 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 Enterprise

#

Come riconosco reCAPTCHA v2 Enterprise prima di scegliere un tipo?

reCAPTCHA v2 Enterprise è una chiave Enterprise con checkbox o basata su policy, caricata tramite enterprise.js e grecaptcha.enterprise. Usa recaptcha_v2_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 v2 Enterprise?

Copia la chiave Enterprise da data-sitekey o da grecaptcha.enterprise.render; conserva page_action ed enterprise_payload solo se l'integrazione di destinazione li fornisce. Fornisci website_url e website_key. I parametri facoltativi sono enterprise_payload, page_action, invisible e api_domain.

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

L'API reCAPTCHA v2 Enterprise restituisce un token in gRecaptchaResponse. Il formato della soluzione è token. Restituisce comunque gRecaptchaResponse, ma gli identificatori e i payload Enterprise non vanno mescolati con i valori api.js della v2 classica né con le chiavi v3 basate su punteggio.

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

Google Cloud documenta le chiavi Enterprise con checkbox, data-sitekey, data-action e grecaptcha.enterprise.render. [Apri il riferimento per reCAPTCHA v2 Enterprise](https://docs.cloud.google.com/recaptcha/docs/instrument-web-pages-with-checkbox). I campi specifici di EverySolve e la disponibilità in tempo reale restano comunque quelli del catalogo dei tipi.

Riferimento per reCAPTCHA v2 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

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