API Challenge PerimeterX 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 Challenge PerimeterX di EverySolve restituisce valori dei cookie per il tuo flusso di gestione delle challenge.PerimeterX, ora parte di HUMAN Security, è un flusso di protezione delle applicazioni a livello di pagina, non una checkbox incorporata. Restituisce i cookie che consentono l'accesso alla sessione protetta, non un token per un modulo né un annuncio immobiliare tratto da un sito protetto.

Invia POST https://api.everyinfra.com/api/v1/captcha con type impostato su perimeterx. 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 «Challenge PerimeterX» 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 perimeterx 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.
- 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.
- Parametri facoltativi:
- user_agent: Lo user agent del browser per questa sessione della challenge; mantienilo invariato quando il risultato restituito è legato a quella sessione.
- website_key: La chiave pubblica del sito o del widget copiata da questa esatta integrazione di destinazione; non è una chiave segreta.
- Esempio di corpo della richiesta:
{
"type": "perimeterx",
"website_url": "<website_url>",
"proxy": "<proxy>"
}
- 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ì	`perimeterx`	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.
`proxy`	body	`string`	Sì	-	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.
`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.
`website_key`	body	`string`	No	-	La chiave pubblica del sito o del widget copiata da questa esatta integrazione di destinazione; non è una chiave segreta.

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": "perimeterx",
  "website_url": "<website_url>",
  "proxy": "<proxy>"
}'

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

Da dove provengono i parametri di Challenge PerimeterX

Usa website_url con lo stesso proxy che utilizzerà il risultato; user_agent e website_key si applicano solo quando il sito di destinazione li espone.

Codice per trovare questi valori nella pagina

perimeterx-1.js

({appId: window._pxAppId, vid: window._pxVid, uuid: window._pxUuid,
  host: window._pxHostUrl, jsClient: window._pxJsClientSrc,
  firstParty: window._pxFirstPartyEnabled, mobile: window._pxMobile})

perimeterx-2.txt

appId: "PXHYx10rg3"  hostUrl: "/HYx10rg3/xhr"
jsClient: "/HYx10rg3/init.js"  firstParty: true
uuid: "cce30591-a3d2-11f1-8eac-300ab9bc7c1b"

perimeterx-3.js

window._pxAppId ||
(document.documentElement.innerHTML.match(/PX[A-Za-z0-9]{8,10}/) || [])[0] ||
[...document.scripts].map(s=>s.src).find(s=>/perimeterx\.net|px-cdn\.net/.test(s))

Come riconoscere Challenge PerimeterX

PerimeterX, ora parte di HUMAN Security, è un flusso di protezione delle applicazioni a livello di pagina, non una checkbox incorporata.

Cosa distingue Challenge PerimeterX

Restituisce i cookie che consentono l'accesso alla sessione protetta, non un token per un modulo né un annuncio immobiliare tratto da un sito protetto.

Come usare l'API Challenge PerimeterX

L'API Challenge PerimeterX restituisce valori dei cookie in cookie. Il formato della soluzione è cookie. Aggiungi i campi dei cookie restituiti alle richieste successive dello stesso flusso.

01Esegui GET /api/v1/captcha/types e seleziona la voce perimeterx.
02Nella richiesta POST /api/v1/captcha, invia type: "perimeterx" e i parametri obbligatori.
03Leggi valori dei cookie da cookie.
04Aggiungi i campi dei cookie restituiti alle richieste successive dello stesso flusso.

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 Challenge PerimeterX

Come riconosco Challenge PerimeterX prima di scegliere un tipo?

PerimeterX, ora parte di HUMAN Security, è un flusso di protezione delle applicazioni a livello di pagina, non una checkbox incorporata. Usa perimeterx 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 Challenge PerimeterX?

Usa website_url con lo stesso proxy che utilizzerà il risultato; user_agent e website_key si applicano solo quando il sito di destinazione li espone. Fornisci website_url e proxy. I parametri facoltativi sono user_agent e website_key.

Cosa restituisce Challenge PerimeterX e con cosa non va confuso?

L'API Challenge PerimeterX restituisce valori dei cookie in cookie. Il formato della soluzione è cookie. Restituisce i cookie che consentono l'accesso alla sessione protetta, non un token per un modulo né un annuncio immobiliare tratto da un sito protetto.

Quale fonte esterna spiega l'integrazione di Challenge PerimeterX?

La documentazione ufficiale di HUMAN Security identifica la famiglia di soluzioni di protezione delle applicazioni PerimeterX. [Apri il riferimento per Challenge PerimeterX](https://www.humansecurity.com/). I campi specifici di EverySolve e la disponibilità in tempo reale restano comunque quelli del catalogo dei tipi.

Riferimento per Challenge PerimeterX

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