API
Para fines de automatización, Death By Captcha (DBC) proporciona API para que los usuarios y desarrolladores se integren con cualquier software dado.
El proceso para resolver es el siguiente:
¡Consulte los detalles de nuestra API a continuación para obtener información y recursos adicionales para implementar DBC utilizando su(s) herramienta(s) y/o lenguaje de programación favoritos!
- .NET (C#, VB, GitHub, Selenium, NuGet)
- AutoIt3
- C (Código fuente del cliente y biblioteca)
- Java (GitHub, Maven, Selenium)
- Perl 5+
- PHP v7+
- Python3 (GitHub, PyPI, Selenium)
- Node.js (GitHub, npm, Selenium)
- Herramienta de línea de comandos para Windows, Linux (i386 and x86-64) (ver nota de uso a continuación)
Para otros idiomas, consulte nuestro API metadata specifications (OpenAPI/AsyncAPI) para generar clientes automáticamente.
Clientes de terceros
- CAPTCHAs de imagen normales con texto (incluyendo CAPTCHAs sensibles a mayúsculas y minúsculas, CAPTCHAs de matemáticas, etc.)
- ReCAPTCHA by Token API ( reCAPTCHA V2, V3, Invisible & Enterprise) BETA
- Geetest Challenges NUEVO BETA
- TextCAPTCHA NUEVO BETA
- Cloudflare Turnstile NUEVO BETA
- Audio Captcha NUEVO BETA
- Lemin Cropped NUEVO BETA
- Capy Puzzle! NUEVO BETA
- Amazon WAF NUEVO BETA
- Cyber Siara NUEVO BETA
- Mtcaptcha NUEVO BETA
- Cutcaptcha NUEVO BETA
- Friendly Captcha NUEVO BETA
- Datadome NUEVO BETA
- Tencent NUEVO BETA
- Atb Captcha NUEVO BETA
- Support for legacy/outdated reCAPTCHA solving via Coordinates or Image Group
Estamos usando la línea de comandos dotnet 10+ (también es compatible con net8.0 y net6.0)
Asegúrese de que ya ha descargado el controlador del navegador selenium
y doble verificación que el ejecutable del controlador está en PATH
Puede usar ChromeDriver para Chrome o Geckodriver para Firefox
y puede cambiar entre estos controladores en el código fuente de C#.
Clonar el proyecto .NET desde GitHub
git clone https://github.com/deathbycaptcha/deathbycaptcha-api-client-dotnet
Las credenciales se leen de variables de entorno:
DBC_USERNAME=your_username
DBC_PASSWORD=your_password
En la carpeta donde dbc_api_net.sln archivo se encuentra
Ejecute los siguientes comandos para ejecutar el ejemplo de Selenium:
dotnet restore dbc_api_net.sln
dotnet run --project DBC_Examples/DBC_Examples.csproj -c Release -f net10.0 -p:ExamplesStartupObject=DeathByCaptcha.SeleniumRecaptchaV2Example
Refer a ejemplos de proyectos .NET para más detalles
Estamos utilizando Maven 3.6+
Asegúrese de que ya ha descargado el controlador del navegador selenium
y doble verificación el ejecutable del controlador está en PATH
Puede usar ChromeDriver para Chrome o Geckodriver para Firefox
y puede cambiar entre estos controladores en el código fuente de Java.
Descargar el proyecto de Java Selenium de la lista anterior
Editar App.java y poner sus credenciales allí
Client client = new HttpClient("DBC_USERNAME", "DBC_PASSWORD");
En la carpeta donde pom.xml archivo se encuentra
Ejecute los siguientes comandos para ejecutar el ejemplo:
mvn clean install -U para limpiar el proyecto e instalar dependencias
mvn exec:java -Dexec.mainClass="deathbycaptcha.App" para construir el proyecto
mvn clean para limpiar el proyecto
Refer a ejemplos de proyectos Java y Maven para más detalles
Estamos utilizando NodeJS v22+
Asegúrese de que ya ha descargado el controlador del navegador selenium
y doble verificación que el ejecutable del controlador está en PATH
Puede usar ChromeDriver para Chrome o Geckodriver para Firefox
y puede cambiar entre estos controladores en el código fuente de NodeJS.
Clonar el proyecto NodeJS desde GitHub
git clone https://github.com/deathbycaptcha/deathbycaptcha-api-client-nodejs
Editar examples/selenium/recaptcha_v2_selenium.js y poner sus credenciales allí
const USERNAME = 'DBC_USERNAME' // Su nombre de usuario de DBC aquí
const PASSWORD = 'DBC_PASSWORD' // Su contraseña de DBC aquí
En la carpeta donde package.json archivo se encuentra
Ejecute los siguientes comandos para ejecutar el ejemplo:
npm install deathbycaptcha-lib // para instalar la biblioteca DBC desde npm
node examples/selenium/recaptcha_v2_selenium.js // para ejecutar el ejemplo
Refer a ejemplos de proyectos NodeJS para más detalles
Estamos utilizando Python v3+
Asegúrese de que ya ha descargado el controlador del navegador selenium
y doble verificación el ejecutable del controlador está enPATH
Puede usar ChromeDriver para Chrome o Geckodriver para Firefox
y puede cambiar entre estos controladores en el código fuente de Python3.
Descargar el proyecto de Python3 Selenium de la lista anterior
Editar python_selenium_example.py y ponga sus credenciales allí
USERNAME = 'DBC_USERNAME' # Su nombre de usuario de DBC aquí
PASSWORD = 'DBC_PASSWORD' # Su contraseña de DBC aquí
En la carpeta donde requirements.txt archivo se encuentra
Ejecute los siguientes comandos para ejecutar el ejemplo:
python3 -m venv venv para crear un nuevo venv python3
. venv/bin/activate para activar el venv
pip3 install -r requirements.txt para instalar dependencias
python3 python_selenium_example.py
Refer a ejemplos de proyectos Python3 para más detalles
Crear nuevo entorno virtual de Python3
python3 -m venv venv
Activar el entorno virtual
. venv/bin/activate
Instalar biblioteca DeathByCaptcha desde pypi
pip install deathbycaptcha-official
Crear nuestro script de python3
import deathbycaptcha
# don't forget to import deathbycaptcha library
username = 'username'
password = 'password'
authtoken = ''
...
use el cliente DeathByCaptcha python http
http_client = deathbycaptcha.HttpClient(username, password, authtoken)
o use el cliente DeathByCaptcha python sockets
socket_client = deathbycaptcha.SocketClient(username, password, authtoken)
Refer a ejemplos de proyectos Python3 para más detalles.
Crear nuevo proyecto Maven
mvn -B archetype:generate -DarchetypeGroupId=org.apache.maven.archetypes -DarchetypeArtifactId=maven-archetype-quickstart -DarchetypeVersion=1.5 -DgroupId=examples -DartifactId=deathbycaptcha-examples -Dpackage=examples -Dmaven.compiler.release=25
Incluir las siguientes dependencias en el archivo maven pom.xml
<dependencies>
<dependency>
<groupId>io.github.deathbycaptcha</groupId>
<artifactId>deathbycaptcha-java-library</artifactId>
<version>4.7.0</version>
</dependency>
</dependencies>
si el pom.xml es correcto.
Podemos usar las importaciones en nuestros archivos java.
import com.DeathByCaptcha.AccessDeniedException;
import com.DeathByCaptcha.Client;
import com.DeathByCaptcha.HttpClient;
import com.DeathByCaptcha.SocketClient;
import com.DeathByCaptcha.Captcha;
...
Limpiar y compilar el proyecto
mvn clean install -U
Ejecutar el proyecto
mvn exec:java -Dexec.mainClass="examples.GetBalance" -Dexec.args=""
mvn exec:java -Dexec.mainClass="examples.ExampleRecaptchaV2"
...
Refer a ejemplos de proyectos Java y Maven para más detalles
Cuando use clientes de Socket API, asegúrese de no tener conexiones TCP salientes a los puertos 8123-8130 mediante Firewall. Use clientes de API HTTP si los clientes API de socket no funcionan para usted. El rango de puertos 8123-8130 es solo para API de socket, no intente usarlo con la API HTTP!
Tenga en cuenta que la llamada a la función/método de decodificación puede devolver un valor nulo si se alcanza el tiempo de espera antes de que se resuelva la captcha. Si esto sucede a menudo, aumente el tiempo de espera utilizado.
Para obtener más detalles, consulte ejemplos incluidos en cada paquete de cliente API y verifique el código fuente del cliente.
- Para verificar su saldo, ejecute:
deathbycaptcha.exe -l USERNAME -p PASSWORD -b
O usando token de autenticacióndeathbycaptcha.exe -a AUTHTOKEN -b
Su saldo se guardará en el archivobalance.txty saldra imprimido en la salida estándar. - Para subir un captcha, ejecute:
deathbycaptcha.exe -l USERNAME -p PASSWORD -c CAPTCHA_FILE_NAME [-t TIMEOUT]
O usando token de autenticacióndeathbycaptcha.exe -a AUTHTOKEN -c CAPTCHA_FILE_NAME [-t TIMEOUT]
El tiempo de espera de resolución de captcha predeterminado es de 60 segundos.
Si se resuelve, el ID del Captcha se guardará enid.txt, el texto del Captcha se guardará enrespuesta.txt, y tanto ID como texto se imprimirán en el Salida estándar separada por un espacio. - Para informar un captcha resuelto incorrectamente, ejecute:
deathbycaptcha.exe -l USERNAME -p PASSWORD -n CAPTCHA_ID
O usando token de autenticacióndeathbycaptcha.exe -a AUTHTOKEN -n CAPTCHA_ID
Antes de implementar su propio Death By Captcha Cliente HTTP API, por favor considere seriamente el uso de la API de socket con uno de nuestros clientes oficiales mencionados anteriormente.
La URL de la API es http://api.dbcapi.me/api/.
La ruta de url cambia dependiendo de la acción deseada. Todas las respuestas de las solicitudes realizadas a la API tienen dos campos comunes:
status— estado de la solicitud. 0 Si no hubo errores durante el procesamiento de solicitudes internos, 255 de lo contrario.error— Breve explicación del error ocurrido. Solo se tiene cuando el estado es 255.
Para obtener detalles sobre la ruta de URL correcta y otros campos devueltos para una acción específica, consulte su sección a continuación.
All API responses are returned URL-encoded by default. If JSON encoding is desired, include application/json in the Accept header of your request. Note that boolean true will be returned as 1 in URL-encoded responses and as true in JSON-encoded responses. Boolean false will be returned as 0 in URL-encoded responses and as false in JSON-encoded responses.
¿Qué son los desafíos de "captcha normal"?
Esta forma de CAPTCHA se basa en imágenes y requiere ingresar una secuencia de letras o números de una imagen distorsionada.
Para subir un captcha, emita una solicitud POST multipart/form-data a http://api.dbcapi.me/api/captcha.
La solicitud debe contener los siguientes campos:
username— Tu nombre de usuario Death By Captcha.password— Su contraseña Death By Captcha.captchafile— la imagen de Captcha.
En caso de que esté utilizando la autenticación de token:
authtoken— Tu token de autenticación Death By Captcha.captchafile— la imagen de Captcha.
captchafile Debe ser un archivo de imagen CAPTCHA sin procesar o una imagen CAPTCHA codificada en base64, con el prefijo base64: agregado. El tamaño del archivo de imagen está limitado a menos de 180 KB. Cuando la imagen se codifica en base64, su tamaño debe ser menor a 120 KB. Los formatos de imagen admitidos son JPG, PNG, GIF y BMP.
Aquí está el formulario HTML que hace el truco:
<form action="http://api.dbcapi.me/api/captcha"method="post" enctype="multipart/form-data">
<input type="text" name="username" value="">
<input type="password" name="password" value="">
<input type="file" name="captchafile">
</form>
O usando la autenticación de token:
<form action="http://api.dbcapi.me/api/captcha"method="post" enctype="multipart/form-data">
<input type="text" name="authtoken" value="">
<input type="file" name="captchafile">
</form>
Aquí está el comando curl equivalente:
curl --header 'Expect: ' -F username=YOUR_USERNAME -F password=YOUR_PASSWORD -F captchafile=@YOUR_CAPTCHA_FILENAME http://api.dbcapi.me/api/captcha
O usando la autenticación de token:
curl --header 'Expect: ' -F authtoken=YOUR_AUTHTOKEN -F captchafile=@YOUR_CAPTCHA_FILENAME http://api.dbcapi.me/api/captcha
El campo base64-encoded captchafile debería verse así:
base64:R0lGODlhAQABAIABAAAAAP///yH5BAEAAAEALAAAAAABAAEAAAICTAEAOw==
Obtendrá una de las siguientes respuestas HTTP:
-
303 See OtherSi su Captcha se cargó correctamente, el encabezado HTTPLocationle indicará la página de estado del captcha subido, puede seguir laubicaciónque obtenga del estado de captcha subido. Además, se devolverán los siguientes campos:
captcha— ID del captcha subido.is_correct— 1 Si se ha identificado una respuesta para este captcha o si todavía se está procesando, 0 si el procesamiento termina y no se pudo encontrar ninguna respuesta.text— Respuesta de Captcha. Una cadena vacía significa que el Captcha aún no está resuelto.
status=0&captcha=123&is_correct=1&text=
Ejemplo con codificación JSON:{ "status": 0, "captcha": 123, "is_correct": 1, "text": "" } -
403 ForbiddenSi sus credenciales Death By Captcha fueron rechazadas o no tiene suficientes créditos. -
400 Bad RequestSi su solicitud no siguió la especificación anterior, o el Captcha fue rechazado por no ser una imagen válida. -
500 Internal Server ErrorSi algo sucedió de nuestro lado evitando que suba la captcha; Si está seguro de que está enviando solicitudes correctamente estructuradas con imágenes Captcha válidas, pero el problema persiste, comuníquese con nuestro soporte en vivo y dígales en detalle cómo reproducir el problema. -
503 Service Temporarily UnavailableCuando nuestro servicio esté sobrecargado, intente nuevamente más tarde.
En este punto, el CAPTCHA que acaba de subir puede no haber sido resuelto todavía! Si no recibió la respuesta en el campo text de la respuesta del servidor, debe consultarlo. Consulte Consulta para el estado del CAPTCHA cargado para obtener más detalles.
Para obtener el estado de un captcha cargado, emita una solicitud GET para obtener
http://api.dbcapi.me/api/captcha/%CAPTCHA_ID%,
Donde %CAPTCHA_ID% es la identificación de su CAPTCHA cargado adquirida al cargar el CAPTCHA.
Esta vez no tiene que proporcionar sus credenciales Death By Captcha.
La respuesta será una respuesta HTTP 200 OK con los mismos campos descritos para el 303 Ver Otro de la sección Carga de CAPTCHA.
Si el captcha aún no se resuelve, text vendrá vacío. Tendrás que seguir consultando para esta respuesta. Respuestas de ejemplo:
-
Respuesta codificada por URL de un captcha correctamente resuelto
status=0&captcha=1234&is_correct=1&text=tyrone+slothrop
-
Respuesta codificada por JSON de un captcha correctamente resuelto
{ "captcha": 1234, "is_correct": true,"status": 0, "text": "tyrone slothrop" } -
Respuesta codificada por JSON de un captcha resuelto incorrectamente
{ "captcha": 1234, "is_correct": false, "status": 0, "text": "?" } -
Respuesta codificada por JSON de una captcha inexistente
{ "captcha": 0, "status": 0 }Si obtiene esta respuesta, confirme que la ID de la Captcha que está utilizando para consultar la respuesta es la misma que se devuelve cuando se cargó. Si el problema persiste, no dude en contáctarnos.
Por favor, no consulte un estado de captcha más de una vez en un par de segundos.
Esto se considera abusivo y podría llevarte a ser baneado.
Conserva tu ancho de banda y el nuestro.
Si cree que su captcha se resolvió incorrectamente, infórmelo a Death By Captcha para recuperar su dinero.
Para hacerlo, emita una solicitud POST a http://api.dbcapi.me/api/captcha/%CAPTCHA_ID%/report con los siguientes campos:
username— Tu nombre de usuario Death By Captcha.password— Su contraseña Death By Captcha.
O usando token de autenticación:
authtoken— Tu token de autenticación Death By Captcha.
La respuesta será:
200 OKSi se completó el reporte. En este caso, sus créditos serán reembolsados. El cuerpo de respuesta será el mismo que para una consulta (o subida) pero el campois_correctserá 0. Ejemplo:{ "captcha": 1234, "is_correct": false,"status": 0, "text": "tyrone slothrop" }503 Service UnavailableSi el reporte no pudiera completarse. Esto podría deberse a que:
1) Captcha correspondiente al ID proporcionado no fue cargado por el usuario que lo informó;
2) Su usuario está baneado;
3) El informe se realizó más de una hora después de que se cargó. En este caso, no serás reembolsado.
¡Abusar de esta característica te baneara!
Para verificar su saldo de crédito, emita una solicitud GET a http://api.dbcapi.me/api con los siguientes campos:
username— Tu nombre de usuario Death By Captcha.password— Su contraseña Death By Captcha.
O usando token de autenticación:
authtoken— Tu token de autenticación Death By Captcha.
En la autenticación exitosa, obtendrá 200 OK Respuesta con sus Detalles de la cuenta Death By Captcha, ya sea en codificación de URL o JSON, con los siguientes campos:
user— su ID de cuenta Death By Captcha;rate— Cuánto le cobramos por un Captcha correctamente resuelto, en US¢;balance— Su saldo de crédito actual, en US¢.is_banned— 1 Si el usuario está baneado, 0 si no.
Ejemplo de respuesta codificada por JSON:
{ "is_banned": false, "status": 0, "rate": 0.139,"balance": 455.23, "user": 43122 }
Para recibir el estado actual del servidor, emita una solicitud GET a http://api.dbcapi.me/api/status. La respuesta tendrá los siguientes campos:
todays_accuracy— número que representa la precisión en el porcentaje (por ejemplo, 99.6 representa el 99.6%)solved_in— Tiempo de resolución promedio en segundosis_service_overloaded— 1 Si el servicio está sobrecargado, 0 de lo contrario
Ejemplo de respuesta codificada por JSON:
{ "status": 0, "todays_accuracy": 99.9, "solved_in": 5.3,"is_service_overloaded": false }
- DeCaptcher API (Tanto para socket como http)
- Antigate (Anti-Captcha)
- 2captcha

Spanish
English
Russian
Chinese
French
Hindi
Arabic
Bengali
Indonesian
Portuguese
com, 

