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 hCaptcha di EverySolve restituisce un token per il tuo flusso di gestione delle challenge.hCaptcha è un widget h-captcha o una chiamata esplicita a hcaptcha.render con un proprio data-sitekey. L'API restituisce la risposta di hCaptcha in gRecaptchaResponse. Il nome del campo non rende il widget un Google reCAPTCHA.

Invia POST https://api.everyinfra.com/api/v1/captcha con type impostato su hcaptcha. Inserisci i parametri nel corpo della richiesta, allo stesso livello di type. $4.58 per 1.000 risoluzioni riuscite ($0.004583 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 «hCaptcha» 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 hcaptcha 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.
- Esempio di corpo della richiesta:
{
  "type": "hcaptcha",
  "website_url": "<website_url>",
  "website_key": "<website_key>"
}
- Addebito: $4.58 per 1.000 risoluzioni riuscite ($0.004583 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ìhcaptchaTipo 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.

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

Da dove provengono i parametri di hCaptcha

#

Copia la site key di hCaptcha dal widget del target e conserva l'URL della pagina in cui il widget viene mostrato.

Codice per trovare questi valori nella pagina

hcaptcha-1.html
<div class="h-captcha" data-sitekey="your_site_key"></div>
hcaptcha-2.js
widgetId = hcaptcha.render('hcaptcha-container', {
  sitekey: 'your_site_key_here', size: 'invisible', callback: onSolve });

Come riconoscere hCaptcha

#

hCaptcha è un widget h-captcha o una chiamata esplicita a hcaptcha.render con un proprio data-sitekey.

Cosa distingue hCaptcha

L'API restituisce la risposta di hCaptcha in gRecaptchaResponse. Il nome del campo non rende il widget un Google reCAPTCHA.

Come usare l'API hCaptcha

#

L'API hCaptcha 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 hcaptcha.
  2. 02Nella richiesta POST /api/v1/captcha, invia type: "hcaptcha" 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 hCaptcha

#

Come riconosco hCaptcha prima di scegliere un tipo?

hCaptcha è un widget h-captcha o una chiamata esplicita a hcaptcha.render con un proprio data-sitekey. Usa hcaptcha 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 hCaptcha?

Copia la site key di hCaptcha dal widget del target e conserva l'URL della pagina in cui il widget viene mostrato. Fornisci website_url e website_key. I parametri facoltativi sono invisible.

Cosa restituisce hCaptcha e con cosa non va confuso?

L'API hCaptcha restituisce un token in gRecaptchaResponse. Il formato della soluzione è token. L'API restituisce la risposta di hCaptcha in gRecaptchaResponse. Il nome del campo non rende il widget un Google reCAPTCHA.

Quale fonte esterna spiega l'integrazione di hCaptcha?

La documentazione ufficiale di hCaptcha mostra il widget, la site key e l'integrazione del token di risposta. [Apri il riferimento per hCaptcha](https://docs.hcaptcha.com/). I campi specifici di EverySolve e la disponibilità in tempo reale restano comunque quelli del catalogo dei tipi.

Riferimento per hCaptcha

#
#

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