API CAPTCHA di DataDome 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 CAPTCHA di DataDome di EverySolve restituisce valori dei cookie per il tuo flusso di gestione delle challenge.Il task CAPTCHA di DataDome parte da un captcha_url già emesso per una sessione bloccata. Restituisce dati cookie legati a quel flusso. datadome_interstitial parte invece dall'URL di un sito protetto, non da un URL CAPTCHA.

Invia POST https://api.everyinfra.com/api/v1/captcha con type impostato su datadome. Inserisci i parametri nel corpo della richiesta, allo stesso livello di type. $2.5 per 1.000 risoluzioni riuscite ($0.0025 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 «CAPTCHA di DataDome» 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 datadome e inserisci i parametri accanto, allo stesso livello.
- Parametri obbligatori:
- captcha_url: L'URL completo della challenge emesso per la sessione bloccata attiva, non la home page del sito.
- 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.
- Parametri facoltativi:
- website_url: La pagina esatta in cui compare questa challenge, incluso il percorso pertinente e non solo la home page del sito.
- Esempio di corpo della richiesta:
{
"type": "datadome",
"captcha_url": "<captcha_url>",
"user_agent": "<user_agent>",
"proxy": "<proxy>"
}
- Addebito: $2.5 per 1.000 risoluzioni riuscite ($0.0025 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ì	`datadome`	Tipo di CAPTCHA, valore fisso.
`captcha_url`	body	`string`	Sì	-	L'URL completo della challenge emesso per la sessione bloccata attiva, non la home page del sito.
`user_agent`	body	`string`	Sì	-	Lo user agent del browser per questa sessione della challenge; mantienilo invariato quando il risultato restituito è legato a quella sessione.
`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.
`website_url`	body	`string`	No	-	La pagina esatta in cui compare questa challenge, incluso il percorso pertinente e non solo la home page del sito.

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

Da dove provengono i parametri di CAPTCHA di DataDome

Invia captcha_url, lo user_agent della sessione e lo stesso proxy che userà il cookie; website_url è contesto facoltativo.

Codice per trovare questi valori nella pagina

datadome-1.js

// When the block appears, the challenge URL is usually in location or in a loaded resource
location.href.includes('captcha-delivery.com') ? location.href :
  [...performance.getEntriesByType('resource')].map(e=>e.name)
    .find(u=>u.includes('captcha-delivery.com'))

datadome-2.js

document.cookie.split('; ').find(c => c.startsWith('datadome='))

Come riconoscere CAPTCHA di DataDome

Il task CAPTCHA di DataDome parte da un captcha_url già emesso per una sessione bloccata.

Cosa distingue CAPTCHA di DataDome

Restituisce dati cookie legati a quel flusso. datadome_interstitial parte invece dall'URL di un sito protetto, non da un URL CAPTCHA.

Come usare l'API CAPTCHA di DataDome

L'API CAPTCHA di DataDome 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 datadome.
02Nella richiesta POST /api/v1/captcha, invia type: "datadome" 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 CAPTCHA di DataDome

Come riconosco CAPTCHA di DataDome prima di scegliere un tipo?

Il task CAPTCHA di DataDome parte da un captcha_url già emesso per una sessione bloccata. Usa datadome 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 CAPTCHA di DataDome?

Invia captcha_url, lo user_agent della sessione e lo stesso proxy che userà il cookie; website_url è contesto facoltativo. Fornisci captcha_url, user_agent e proxy. I parametri facoltativi sono website_url.

Cosa restituisce CAPTCHA di DataDome e con cosa non va confuso?

L'API CAPTCHA di DataDome restituisce valori dei cookie in cookie. Il formato della soluzione è cookie. Restituisce dati cookie legati a quel flusso. datadome_interstitial parte invece dall'URL di un sito protetto, non da un URL CAPTCHA.

Quale fonte esterna spiega l'integrazione di CAPTCHA di DataDome?

Il sito ufficiale di DataDome descrive il contesto dei suoi prodotti CAPTCHA e di protezione dai bot. [Apri il riferimento per CAPTCHA di DataDome](https://datadome.co/). I campi specifici di EverySolve e la disponibilità in tempo reale restano comunque quelli del catalogo dei tipi.

Riferimento per CAPTCHA di DataDome

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