API Castle 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 Castle di EverySolve restituisce un set di token per il tuo flusso di gestione delle challenge.Castle è un flusso di valutazione del rischio e device intelligence in cui il target fornisce metadati strutturati anziché un puzzle visivo. Restituisce un set di token. Non ridurre il set a un singolo token e non dedurre un CAPTCHA visivo dal nome del prodotto.

Invia POST https://api.everyinfra.com/api/v1/captcha con type impostato su castle. Inserisci i parametri nel corpo della richiesta, allo stesso livello di type. $0.97 per 1.000 token ($0.000972 per token). Ogni chiamata viene addebitata per token: il prezzo × count. Paghi solo i token restituiti. Le chiamate non riuscite e i risultati vuoti non vengono addebitati.

Prompt per l'AI

Aiutami a scrivere uno script che chiami l'API «Castle» 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 castle 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.
- metadata: I metadati client pubblici e strutturati richiesti dal flusso Castle di destinazione.
- Parametri facoltativi:
- count: Il numero di risultati richiesti per questo task, entro i limiti indicati nel catalogo.
- user_agent: Lo user agent del browser per questa sessione della challenge; mantienilo invariato quando il risultato restituito è legato a quella sessione.
- proxy: Il proxy per la sessione di risoluzione; quando un risultato è legato alla rete, usa lo stesso punto di uscita per la successiva richiesta al sito di destinazione.
- Esempio di corpo della richiesta:
{
"type": "castle",
"website_url": "<website_url>",
"website_key": "<website_key>",
"metadata": "<metadata>"
}
- Addebito: $0.97 per 1.000 token ($0.000972 per token). Ogni chiamata viene addebitata per token: il prezzo × count. Paghi solo i token restituiti. 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ì	`castle`	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.
`metadata`	body	`object`	Sì	-	I metadati client pubblici e strutturati richiesti dal flusso Castle di destinazione.
`count`	body	`number`	No	-	Il numero di risultati richiesti per questo task, entro i limiti indicati nel catalogo.
`user_agent`	body	`string`	No	-	Lo user agent del browser per questa sessione della challenge; mantienilo invariato quando il risultato restituito è legato a quella sessione.
`proxy`	body	`string`	No	-	Il proxy per la sessione di risoluzione; quando un risultato è legato alla rete, usa lo stesso punto di uscita per la successiva richiesta al sito di destinazione.

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

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

Da dove provengono i parametri di Castle

website_key e metadata devono provenire dalla stessa integrazione del target; count, user_agent e proxy sono contesto facoltativo della richiesta.

Codice per trovare questi valori nella pagina

castle-1.js

[...document.scripts].map(s=>s.src).filter(s=>/castle\.io/.test(s))

Come riconoscere Castle

Castle è un flusso di valutazione del rischio e device intelligence in cui il target fornisce metadati strutturati anziché un puzzle visivo.

Cosa distingue Castle

Restituisce un set di token. Non ridurre il set a un singolo token e non dedurre un CAPTCHA visivo dal nome del prodotto.

Come usare l'API Castle

L'API Castle restituisce un set di token in tokens. Il formato della soluzione è tokens. Invia insieme i token restituiti, nel modo previsto dalla richiesta del sito di destinazione.

01Esegui GET /api/v1/captcha/types e seleziona la voce castle.
02Nella richiesta POST /api/v1/captcha, invia type: "castle" e i parametri obbligatori.
03Leggi un set di token da tokens.
04Invia insieme i token restituiti, nel modo previsto dalla richiesta del sito di destinazione.

Addebiti e disponibilità Questo tipo ha un prezzo per token: ogni chiamata costa il prezzo indicato × count e paghi solo per i token restituiti. 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 Castle

Come riconosco Castle prima di scegliere un tipo?

Castle è un flusso di valutazione del rischio e device intelligence in cui il target fornisce metadati strutturati anziché un puzzle visivo. Usa castle 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 Castle?

website_key e metadata devono provenire dalla stessa integrazione del target; count, user_agent e proxy sono contesto facoltativo della richiesta. Fornisci website_url, website_key e metadata. I parametri facoltativi sono count, user_agent e proxy.

Cosa restituisce Castle e con cosa non va confuso?

L'API Castle restituisce un set di token in tokens. Il formato della soluzione è tokens. Restituisce un set di token. Non ridurre il set a un singolo token e non dedurre un CAPTCHA visivo dal nome del prodotto.

Quale fonte esterna spiega l'integrazione di Castle?

Il sito ufficiale di Castle descrive il contesto del prodotto di valutazione del rischio e device intelligence. [Apri il riferimento per Castle](https://castle.io/). I campi specifici di EverySolve e la disponibilità in tempo reale restano comunque quelli del catalogo dei tipi.

Riferimento per Castle

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