Índice

Descargue los códigos de ejemplo basados en el cliente API:

Nuevo soporte de API de Friendly Captcha

¿Cuáles son los desafíos de "Friendly Captcha"?

Son desafíos que verifican automáticamente si el usuario es humano.

Para su conveniencia, implementamos soporte para Friendly Captcha API. Si su software funciona con él y admite una configuración mínima, debería poder decodificar Friendly Captchas usando Death By Captcha en poco tiempo.

  • Friendly captcha API: Proporcionó una URL del sitio y una clave del sitio Friendly Captcha, la API devuelve un token que usará para enviar el formulario en la página con el desafío Friendly Captcha.

Precios

Por el momento, el precio es de $ 2.89/1k Friendly Captcha desafíos resueltos correctamente. No se le facturará por Friendly Captcha informado como resuelto incorrectamente. Tenga en cuenta que este precio se aplica solo a los nuevos desafíos de Friendly Captcha, por lo que solo los clientes que usan esta API específica se cobrarán dicha tarifa.

Friendly Captcha API Preguntas frecuentes:

¿Cuál es la URL de la API de Friendly Captcha?

Para usar la API Friendly Captcha tendrá que enviar una solicitud de publicación HTTP a http://api.dbcapi.me/api/captcha

¿Cuáles son los parámetros de publicación para la API Friendly Captcha ?

  • username: El nombre de usuario de su cuenta de DBC
  • password: La contraseña de su cuenta de DBC
  • type=20: Tipo 20 Especifica que se trata de una API Friendly Captcha
  • friendly_params=json(payload): los datos para acceder al desafío de Friendly Captcha
  • Estructura de carga utilizando JSON:
    • proxy: Su url de proxy y credenciales (si las hay). Ejemplos:
    • proxytype: Su protocolo de conexión proxy. Para conocer los tipos de proxy compatibles, consulte ¿Qué tipos de proxy son compatibles?. Ejemplo:
      • HTTP
    • sitekey: La clave del sitio de Friendly Captcha del sitio web con Friendly Captcha.

      Ejemplo:

      • FCMGEMUD2KTDSQ5H

      Debe localizar la clave del sitio de Friendly Captcha. Puede ubicar el elemento div de Friendly Captcha y verificar el valor del parámetro Data-SiteKey.

    • pageurl: La URL de la página con los desafíos de Friendly Captcha. Esta URL debe incluir el camino en el que se carga el Friendly Captcha. Ejemplo: si el Friendly Captcha que desea resolver está en http://test.com/path1, Pageurl debe ser http://test.com/path1 y no http://test.com.

    El parámetro proxy es opcional, pero recomendamos encarecidamente usar uno para evitar el rechazo de la página proporcionada debido a inconsistencias entre la IP que resolvió el captcha (el nuestro si no se proporciona ningún proxy) y la IP que presentó la solución para la verificación (tuya).


    Nota: Si se proporciona proxy, proxytype es un parámetro requerido.

    Ejemplo completo de friendly_params:

    
    {
        'proxy': 'http://user:[email protected]:1234',
        'proxytype': 'HTTP',
        'sitekey': 'FCMGESUZ2KTKSQ9H',
        'pageurl': 'https://testsite.com/xxx-test'
    }
                

¿Cuál es la respuesta de la API Friendly Captcha ?

La respuesta de la API de Friendly Captcha tiene la siguiente estructura. Es válido para un uso y tiene una vida útil de 2 minutos. Será una cadena como la siguiente:


"230abf832a7f26303278e54af4e0e47a.ZabHzQdbzRU63mixAQwtkgAAAAAAAAAAxsWi6
f88jps=.AAAAAP6ZAQABAAAA4/cDAAIAAABzGgkAAwAAAPjgAwAEAAAASYMIAAUAAAAcqAc
ABgAAAIgpAgAHAAAAj7MDAAgAAAD5uQIACQAAACGTCAAKAAAAhQsGAAsAAAC5jgQADAAAAK
IuAQANAAAABTYCAA4AAACq/xoADwAAAAy0AwAQAAAAic4CABEAAADTIgQAEgAAAGGjBQATA
AAA6poFABQAAAB8XQUAFQAAAJeIAwAWAAAANMMDABcAAAAwGgEAGAAAAJqVAAAZAAAA6z4A
ABoAAABynwQAGwAAAG2SBAAcAAAAFI8EAB0AAABsGwIAHgAAAEtTAwAfAAAApJgJACAAAAB
xCgQAIQAAAKjkCwAiAAAAYq4AACMAAADEigMAJAAAAJfMAgAlAAAA/ZkBACYAAADmEAsAJw
AAAODODAAoAAAAgRwCACkAAAAs4wEAKgAAADb9BwArAAAAsBcAACwAAADmrgAA.AgAF"
      

¿Qué tipos de proxy son compatibles?

Actualmente, solo se admiten http proxies. El soporte para otros tipos se agregará en el futuro.

Uso de Friendly Captcha API con clientes API:


    /**
     * Death by Captcha PHP API friendly captcha usage example
     *
     * @package DBCAPI
     * @subpackage PHP
     */

    /**
     * DBC API clients
     */
    require_once '../deathbycaptcha.php';

    $username = "username";  // DBC account username
    $password = "password";  // DBC account password
    $token_from_panel = "your-token-from-panel";  // DBC account authtoken

    // Use DeathByCaptcha_SocketClient() class if you want to use SOCKET API.
    $client = new DeathByCaptcha_HttpClient($username, $password);
    $client->is_verbose = true;

    // To use token the first parameter must be authtoken.
    // $client = new DeathByCaptcha_HttpClient("authtoken", $token_from_panel);

    echo "Your balance is {$client->balance} US cents\n";

    // Set the proxy and friendly captcha token data
    $data = array(
        'proxy' => 'http://user:[email protected]:1234',
        'proxytype' => 'HTTP',
        'sitekey' => 'FCMGEMUD2KTDSQ5H',
        'pageurl' => 'https://client-demo.testsite.com/test'
    );
    //Create a json string
    $json = json_encode($data);

    //Put the type and the json payload
    $extra = [
        'type' => 20,
        'friendly_params' => $json,
    ];

    // Put null the first parameter and add the extra payload
    if ($captcha = $client->decode(null, $extra)) {
        echo "CAPTCHA {$captcha['captcha']} uploaded\n";

        sleep(DeathByCaptcha_Client::DEFAULT_TIMEOUT);

        // Poll for CAPTCHA indexes:
        if ($text = $client->get_text($captcha['captcha'])) {
            echo "CAPTCHA {$captcha['captcha']} solved: {$text}\n";

            // Report an incorrectly solved CAPTCHA.
            // Make sure the CAPTCHA was in fact incorrectly solved!
            //$client->report($captcha['captcha']);
        }
    }
        

    # friendly captcha
    import deathbycaptcha
    import json

    # Put your DBC account username and password here.
    username = "username"
    password = "password"

    # you can use authtoken instead of user/password combination
    # activate and get the authtoken from DBC users panel
    authtoken = "authtoken"

    # to use socket client
    # client = deathbycaptcha.SocketClient(username, password)

    # to use authtoken
    # client = deathbycaptcha.SocketClient(username, password, authtoken)

    client = deathbycaptcha.HttpClient(username, password)

    # Put the proxy and friendly captcha data
    Captcha_dict = {
        'proxy': 'http://user:[email protected]:1234',
        'proxytype': 'HTTP',
        'sitekey': 'FCMGEMUD2KTDSQ5H',
        'pageurl': 'https://client-demo.testsite.com/test'
    }

    # Create a json string
    json_Captcha = json.dumps(Captcha_dict)

    try:
        balance = client.get_balance()
        print(balance)

        # Put your CAPTCHA type and Json payload here:
        captcha = client.decode(type=20, friendly_params=json_Captcha)
        if captcha:
            # The CAPTCHA was solved; captcha["captcha"] item holds its
            # numeric ID, and captcha["text"] its text token solution.
            print("CAPTCHA %s solved: %s" % (captcha["captcha"], captcha["text"]))

            if '':  # check if the CAPTCHA was incorrectly solved
                client.report(captcha["captcha"])

    except deathbycaptcha.AccessDeniedException:
        # Access to DBC API denied, check your credentials and/or balance
        print("error: Access to DBC API denied, check your credentials and/or balance")

        

    import com.DeathByCaptcha.AccessDeniedException;
    import com.DeathByCaptcha.Client;
    import com.DeathByCaptcha.HttpClient;
    import com.DeathByCaptcha.SocketClient;
    import com.DeathByCaptcha.Captcha;
    import org.json.JSONObject;

    import java.io.IOException;

    class ExampleFriendlycaptcha {
        public static void main(String[] args)
                throws Exception {

            // Put your DBC username & password or authtoken here:
            String username = "your_username_here";
            String password = "your_password_here";
            String authtoken = "your_authtoken_here";

            /* Death By Captcha Socket Client
               Client client = (Client) (new SocketClient(username, password));
               Death By Captcha http Client */
            Client client = (Client) (new HttpClient(username, password));
            client.isVerbose = true;

            /* Using authtoken
               Client client = (Client) new HttpClient(authtoken); */

            try {
                try {
                    System.out.println("Your balance is " + client.getBalance()
                                                          + " US cents");
                } catch (IOException e) {
                    System.out.println("Failed fetching balance: " + e.toString());
                    return;
                }

                Captcha captcha = null;
                try {
                    // Proxy and friendly captcha data
                    String proxy = "http://user:[email protected]:1234";
                    String proxytype = "http";
                    String sitekey = "FCMGEMUD2KTDSQ5H";
                    String pageurl = "https://client-demo.testsite.com/test";
                    /* Upload a friendly captcha and poll for its status with 120 seconds timeout.
                       Put your proxy, proxy type, page sitekey, page url and solving
                       timeout (in seconds) 0 or nothing for the default timeout value. */
                    JSONObject json_params = new JSONObject();
                    json_params.put("proxy", proxy);
                    json_params.put("proxytype", proxytype);
                    json_params.put("sitekey", sitekey);
                    json_params.put("pageurl", pageurl);
                    captcha = client.decode(20, json_params);
                } catch (IOException e) {
                    System.out.println("Failed uploading CAPTCHA");
                    return;
                }
                if (null != captcha) {
                    System.out.println("CAPTCHA " + captcha.id + " solved: "
                                                               + captcha.text);

                    /* Report incorrectly solved CAPTCHA if necessary.
                       Make sure you've checked if the CAPTCHA was in fact incorrectly
                       solved, or else you might get banned as abuser. */
                    /*try {
                        if (client.report(captcha)) {
                            System.out.println("Reported as incorrectly solved");
                        } else {
                            System.out.println(
                                "Failed reporting incorrectly solved CAPTCHA");
                        }
                    } catch (IOException e) {
                        System.out.println(
                           "Failed reporting incorrectly solved CAPTCHA:" + e.toString());
                    }*/
                } else {
                    System.out.println("Failed solving CAPTCHA");
                }
            } catch (com.DeathByCaptcha.Exception e) {
                System.out.println(e);
            }
        }
    }

        

    // friendly captcha

    using System;
    using System.Collections;
    using DeathByCaptcha;

    namespace DBC_Examples.examples
    {
        public class FriendlycaptchaExample
        {
            public void Main()
            {
                // Put your DeathByCaptcha account username and password here.
                string username = "your username";
                string password = "your password";
                // string token_from_panel = "your-token-from-panel";

                /* Death By Captcha Socket Client
                   Client client = (Client) new SocketClient(username, password);
                   Death By Captcha http Client */
                Client client = (Client) new HttpClient(username, password);

                /* To use token authentication the first parameter must
                be "authtoken".
                Client client = (Client) new HttpClient("authtoken",
                                                        token_from_panel); */

                // Put your Proxy credentials and type here
                string proxy = "http://user:[email protected]:1234";
                string proxyType = "HTTP";
                string sitekey = "FCMGEMUD2KTDSQ5H";
                string pageurl = "https://client-demo.testsite.com/test";

                string friendlyParams = "{\"proxy\": \"" + proxy + "\"," +
                                        "\"proxytype\": \"" + proxyType + "\"," +
                                        "\"sitekey\": \"" + sitekey + "\"," +
                                        "\"pageurl\": \"" + pageurl + "\"}";
                try
                {
                    double balance = client.GetBalance();

                    /* Upload a CAPTCHA and poll for its status. Put the Friendly Captcha
                       Json payload, CAPTCHA type and desired solving timeout
                       (in seconds) here. If solved, you'll receive a
                       DeathByCaptcha.Captcha object. */
                    Captcha captcha = client.Decode(Client.DefaultTimeout,
                        new Hashtable()
                        {
                            {"type", 20},
                            {"friendly_params", friendlyParams}
                        });

                    if (null != captcha)
                    {
                        /* The CAPTCHA was solved; captcha.Id property holds
                        its numeric ID, and captcha.Text holds its text. */
                        Console.WriteLine("CAPTCHA {0} solved: {1}",
                            captcha.Id, captcha.Text);

    //                  if ( /* check if the CAPTCHA was incorrectly solved */)
    //                  {
    //                      client.Report(captcha);
    //                  }
                    }
                }
                catch (AccessDeniedException e)
                {
                    /* Access to DBC API denied,
                                check your credentials and/or balance */
                    Console.WriteLine("<<< catch : " + e.ToString());
                }
            }
        }
    }

        

    Imports DeathByCaptcha

    Public Class Friendlycaptcha
        Sub Main(args As String())

            ' Put your DBC username & password or authtoken here:
            Dim username = "username"
            Dim password = "password"
            Dim token_from_panel = "your-token-from-panel"

            ' DBC Socket API client
            ' Dim client As New SocketClient(username, password)
            ' DBC HTTP API client
            Dim client As New HttpClient(username, password)

            ' To use token auth the first parameter must be "authtoken"
            ' Dim client As New HttpClient("authtoken", token_from_panel)

            ' Proxy and friendly captcha data
            Dim proxy = "http://user:[email protected]:1234"
            Dim proxyType = "HTTP"
            Dim sitekey = "FCMGEMUD2KTDSQ5H"
            Dim pageurl = "https://client-demo.testsite.com/test"

            Console.WriteLine(String.Format("Your balance is {0,2:f} US cents",
                                            client.Balance))

            ' Create a JSON with the extra data
            Dim friendlyParams = "{""proxy"": """ + proxy + """," +
                                 """proxytype"": """ + proxyType + """," +
                                 """sitekey"": """ + sitekey + """," +
                                 """pageurl"": """ + pageurl + """}"

            ' Create the payload with the type and the extra data
            Dim extraData As New Hashtable()
            extraData.Add("type", 20)
            extraData.Add("friendly_params", friendlyParams)

            ' Upload a CAPTCHA and poll for its status. Put the Friendly Captcha
            ' Json payload, CAPTCHA type and desired solving timeout (in seconds)
            ' here. If solved, you'll receive a DeathByCaptcha.Captcha object.
            Dim captcha As Captcha = client.Decode(
                                    DeathByCaptcha.Client.DefaultTimeout, extraData)
            If captcha IsNot Nothing Then
                Console.WriteLine(String.Format("CAPTCHA {0:d} solved: {1}",
                                                captcha.Id, captcha.Text))

                ' Report an incorrectly solved CAPTCHA.
                ' Make sure the CAPTCHA was in fact incorrectly solved, do not
                ' just report it at random, or you might be banned as abuser.
                ' If client.Report(captcha) Then
                '    Console.WriteLine("Reported as incorrectly solved")
                ' Else
                '    Console.WriteLine("Failed reporting as incorrectly solved")
                ' End If
            End If
        End Sub
    End
        

    /*
    * Death by Captcha Node.js API Friendly captcha usage example
    */

    const dbc = require('../deathbycaptcha');

    const username = 'username';     // DBC account username
    const password = 'password';     // DBC account password
    const token_from_panel = 'your-token-from-panel';   // DBC account authtoken

    // Proxy and friendly captcha token data
    const friendly_params = JSON.stringify({
        'proxy': 'http://username:[email protected]:3128',
        'proxytype': 'HTTP',
        'sitekey': 'FCMGEMUD2KTDSQ5H',
        'pageurl': 'https://client-demo.testsite.com/test'
    });

    // Death By Captcha Socket Client
    // const client = new dbc.SocketClient(username, password);
    // Death By Captcha http Client
    const client = new dbc.HttpClient(username, password);

    // To use token authentication the first parameter must be "authtoken"
    // const client = new dbc.HttpClient("authtoken", token_from_panel);

    // Get user balance
    client.get_balance((balance) => {
        console.log(balance);
    });

    // Solve captcha with type 20 & friendly_params extra arguments
    client.decode({extra: {type: 20, friendly_params: friendly_params}},
       (captcha) => {

        if (captcha) {
            console.log('Captcha ' + captcha['captcha'] + ' solved: '
                                                    + captcha['text']);

            /*
            * Report an incorrectly solved CAPTCHA.
            * Make sure the CAPTCHA was in fact incorrectly solved!
            * client.report(captcha['captcha'], (result) => {
            *   console.log('Report status: ' + result);
            * });
            */
        }

    });
        

Estado: OK

Los servidores están completamente operativos con un tiempo de respuesta más rápido que el promedio.
  • Tiempo medio de resolución
  • 5 segundos - Normal CAPTCHAs (1 min. atrás)
  • 39 segundos - reCAPTCHA V2, V3, etc (1 min. atrás)
  • -- segundos - otros (1 min. atrás)
Chrome and Firefox logos
Extensiones de navegador disponibles

Actualizaciones

  1. Nov 14: RESOLVED - Today we experienced API instability between 18:00hrs & 19:00hrs (GMT-4). The main issue was resolved, so CAPTCHA solving is working as usual, however, there might be some stats anomalies that will shortly be fixed. In the meantime, if you need assistance, contact us at https://deathbycaptcha.com/contact and we'll gladly assist you. We apologize for any inconvenience and appreciate your patience and understanding.
  2. Sep 27: LIMITED WEEK-END PROMOTION! 20% OFF ON 2CHECKOUT PACKAGES IF YOU ORDER BETWEEN SEPT 28 & 29 (GMT-4). Get your CAPTCHAs at https://deathbycaptcha.com/user-pay and then contact us at https://deathbycaptcha.com/contact with your order's detail to claim your freebies!
  3. Sep 13: We experienced a brief login issue today, which has now been resolved. Thank you for your patience and understanding!

  4. Actualizaciones anteriores…

Apoyo

Nuestro sistema está diseñado para ser completamente fácil de usar. Si tiene algún problema con él, simplemente envíenos un correo electrónico a Correo electrónico de soporte técnico de DBC com, y un agente de soporte se comunicará con usted lo antes posible.

Soporte en vivo

Disponible de lunes a viernes (10 am a 4 pm EST) Live support image. Link to live support page