API Cloudflare Turnstile 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 Cloudflare Turnstile di EverySolve restituisce un token per il tuo flusso di gestione delle challenge.Cloudflare Turnstile è un widget incorporato configurato con una site key Turnstile. Può essere gestito, non interattivo o invisibile. Restituisce un token per cf-turnstile-response. Una pagina di challenge Cloudflare, invece, blocca la navigazione e restituisce i dati del cookie di clearance.

Invia POST https://api.everyinfra.com/api/v1/captcha con type impostato su turnstile. 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 «Cloudflare Turnstile» 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 turnstile 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:
- action: Il nome dell'azione usato da questa istanza del widget; copialo dall'integrazione di destinazione invece di inventare un'azione generica.
- cdata: Il valore dei dati personalizzati del widget, proveniente dalla stessa istanza della challenge, quando la pagina ne fornisce uno.
- page_data: I dati di pagina serializzati associati a questa istanza del widget, quando il sito di destinazione li espone.
- Esempio di corpo della richiesta:
{
"type": "turnstile",
"website_url": "https://demo.turnstile.workers.dev/",
"website_key": "1x00000000000000000000AA"
}
- 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

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ì	`turnstile`	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.
`action`	body	`string`	No	-	Il nome dell'azione usato da questa istanza del widget; copialo dall'integrazione di destinazione invece di inventare un'azione generica.
`cdata`	body	`string`	No	-	Il valore dei dati personalizzati del widget, proveniente dalla stessa istanza della challenge, quando la pagina ne fornisce uno.
`page_data`	body	`string`	No	-	I dati di pagina serializzati associati a questa istanza del widget, quando il sito di destinazione li espone.

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": "turnstile",
  "website_url": "https://demo.turnstile.workers.dev/",
  "website_key": "1x00000000000000000000AA"
}'

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": "turnstile",  "token": "XXXX.DUMMY.TOKEN.XXXX",  "solution": {    "token": "XXXX.DUMMY.TOKEN.XXXX"  },  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

Da dove provengono i parametri di Cloudflare Turnstile

Copia website_key da data-sitekey o turnstile.render; se presenti, action, cdata e page_data devono provenire dalla stessa istanza del widget.

Codice per trovare questi valori nella pagina

turnstile-1.html

<div class="cf-turnstile" data-sitekey="<YOUR-SITE-KEY>" data-theme="light"
     data-size="normal" data-callback="onSuccess"></div>

turnstile-2.js

const widgetId = turnstile.render("#turnstile-container", {
  sitekey: "<YOUR-SITE-KEY>", callback: function (token) { … },
});

turnstile-3.html

<input type="hidden" name="cf-turnstile-response" value="TOKEN_VALUE" />

Come riconoscere Cloudflare Turnstile

Cloudflare Turnstile è un widget incorporato configurato con una site key Turnstile. Può essere gestito, non interattivo o invisibile.

Cosa distingue Cloudflare Turnstile

Restituisce un token per cf-turnstile-response. Una pagina di challenge Cloudflare, invece, blocca la navigazione e restituisce i dati del cookie di clearance.

Come usare l'API Cloudflare Turnstile

L'API restituisce un token. Inseriscilo nel campo nascosto cf-turnstile-response. Il token scade dopo 300 secondi e si può usare una sola volta.

01Esegui GET /api/v1/captcha/types e seleziona la voce turnstile.
02Nella richiesta POST /api/v1/captcha, invia type: "turnstile" e i parametri obbligatori.
03Leggi un token da token.
04Inserisci il token restituito nel campo nascosto cf-turnstile-response e invialo entro il suo periodo di validità di 300 secondi. Il token si può usare una sola volta.

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 Cloudflare Turnstile

Come riconosco Cloudflare Turnstile prima di scegliere un tipo?

Cloudflare Turnstile è un widget incorporato configurato con una site key Turnstile. Può essere gestito, non interattivo o invisibile. Usa turnstile 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 Cloudflare Turnstile?

Copia website_key da data-sitekey o turnstile.render; se presenti, action, cdata e page_data devono provenire dalla stessa istanza del widget. Fornisci website_url e website_key. I parametri facoltativi sono action, cdata e page_data.

Cosa restituisce Cloudflare Turnstile e con cosa non va confuso?

L'API Cloudflare Turnstile restituisce un token in token. Il formato della soluzione è token. Restituisce un token per cf-turnstile-response. Una pagina di challenge Cloudflare, invece, blocca la navigazione e restituisce i dati del cookie di clearance.

Quale fonte esterna spiega l'integrazione di Cloudflare Turnstile?

Cloudflare documenta il rendering di Turnstile, le modalità del widget, i callback e la gestione dei token. [Apri il riferimento per Cloudflare Turnstile](https://developers.cloudflare.com/turnstile/). I campi specifici di EverySolve e la disponibilità in tempo reale restano comunque quelli del catalogo dei tipi.

Riferimento per Cloudflare Turnstile

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