English
adds-image
Advertisement
adds-image
Advertisement

Status: OK

Average solving time 1 minute ago: 13 sec
5 minutes ago: 6 sec
15 minutes ago: 13 sec
Today's average accuracy rate: 10000.0 %
(updated every minute)

Updates

  1. Nov 23: To ensure optimal service availability, there will be a short, scheduled, server maintenance on Nov. 28, between 11:00 - 11:30 A.M, UTC-4. The service may not be available for a few minutes (we estimate no more than 5 minutes) of that time. We appreciate your patience and understanding!
  2. Aug 18: RESOLVED - To ensure optimal service availability, there will be short, scheduled, server maintenance(s) next Monday Aug 22, by 10:30 A.M. & 1:30 P.M UTC-4. The service may not be available during a few minutes (we estimate less than 10 minutes in total) of that time. We appreciate your patience and understanding!
  3. Jul 07: Check the newest additions on DBC's official page from Pypi for all your Python needs! Also, plenty of Selenium code samples have been added to our API pages.
  4. more…

Support

Our system is designed to be completely user-friendly and easy-to-use. Should you have any trouble with it, simply email us at DBC technical support emailcom, and a support agent will get back to you as soon as possible.

Live Support

Available Monday to Friday (10am to 4pm EST) Live support image. Link to live support page

Using Token authentication

This page is for users that want to use token authentication on Death By Captcha API.

Token authentication FAQ

Why use token authentication?

Token-based authentication allows users to maintain username and password even more secure.

Why are tokens better than passwords?

Traditional passwords have one huge weakness: they’re human-generated. Human-made passwords tend to be pretty weak and easy to crack. We’ve all reused old passwords again and again because they’re easy to remember.

Where can I get my token for authentication?

You can get it from users panel, to use token authentication, you need to enable 2FA authentication.

Refer to 2FA help in order to activate 2FA: Learn how to enable 2FA authentication

After that you can get your token from the User panel

get token

Can I use token authentication and username/password authentication at the same time?

No, you can enable/disable token authentication at any time in user panel, but you cannot use both at the same time. If token authentication is disabled you should use username/password authentication, if token authentication is enabled you should use token authentication.

Where can I enable/disable token authentication?

In user panel there is an option to enable/disable token authentication.

enable/disable token

What should I do next?

When using token authentication on DeathByCaptcha API you need to change your clients to use authtoken instead of username/password.

Refers to each clients code in order to use token based authentication on each case

Client examples

Using token Authentication in PHP:

require_once 'deathbycaptcha.php';

// Put your DBC credentials here.
// Use DeathByCaptcha_HttpClient class if you want to use HTTP API.
// To use token username must be authtoken.
$client = new DeathByCaptcha_SocketClient("authtoken", token-from-panel);

// Put the CAPTCHA file name or handler, and desired timeout (in seconds) here:
if ($captcha = $client->decode(CAPTCHA_FILE_NAME, TIMEOUT)) {
    echo $captcha['text'] . "\n";

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

// Repeat for other CAPTCHAs

Using token authentication in C#:

// Do not forget to reference DeathByCaptcha.dll in your project!
using DeathByCaptcha;

// Put your DBC credentials here.
// Use HttpClient class if you want to use HTTP API.
// Using token authentication in C#/VB, username must be authtoken.

Client client = (Client) new SocketClient("authtoken", token-from-panel);

// Put your CAPTCHA file name, stream, or vector of bytes,
// and desired timeout (in seconds) here:
Captcha captcha = client.Decode(CAPTCHA_FILE_NAME, TIMEOUT);
if (captcha.Solved && captcha.Correct) {
    Console.WriteLine("CAPTCHA {0}: {1}", captcha.Id, captcha.Text);

    // Report the CAPTCHA if solved incorrectly.
    // Make sure the CAPTCHA was in fact incorrectly solved!
    if ( ... ) {
        client.Report(captcha);
    }
}

// Repeat for other CAPTCHAs

Using token authentication in VB.NET:

// Do not forget to reference DeathByCaptcha.dll in your project!
  Imports DeathByCaptcha
        ' Dim clnt As New HttpClient("autoken", token-from-panel)
        Dim clnt As New SocketClient("authtoken", token-from-panel)
        Console.WriteLine(String.Format("Your balance is {0,2:f} US cents", clnt.Balance))
        ' Uploading captchas with type = 2 (Coordinates API)
        ' Dim ext_data As New Hashtable()
        ' ext_data.Add("type", 2)
        ' Put your CAPTCHA image file name, file object, stream, or vector
        ' of bytes, and optional solving timeout (in seconds) here:
        ' Dim cptch As Captcha = clnt.Decode(CAPTCHA_FILE_NAME, 2 * Client.DefaultTimeout, ext_data)
        ' Uploading captchas with type = 3 (Image Group API)
        ' Dim ext_data As New Hashtable()
        ' ext_data.Add("type", 3)
        ' ext_data.Add("banner_text", "Select all images with meat")
        ' ext_data.Add("grid", "4x4") ' this is optional
        ' ext_data.Add("banner", bannerFileName)
        ' Put your CAPTCHA image file name, file object, stream, or vector
        ' of bytes, and optional solving timeout (in seconds) here:
        ' Dim cptch As Captcha = clnt.Decode(CAPTCHA_FILE_NAME, 2 * Client.DefaultTimeout, ext_data)
        ' Put your CAPTCHA image file name, file object, stream, or vector
        ' of bytes, and optional solving timeout (in seconds) here:
        Dim cptch As Captcha = clnt.Decode(CAPTCHA_FILE_NAME, 2 * Client.DefaultTimeout)
        If cptch IsNot Nothing Then
            Console.WriteLine(String.Format("CAPTCHA {0:d} solved: {1}", cptch.Id, cptch.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 clnt.Report(cptch) Then
            '    Console.WriteLine("Reported as incorrectly solved")
            'Else
            '    Console.WriteLine("Failed reporting as incorrectly solved")
            'End If
        End If
  ' Repeat for other CAPTCHAs

Using token authentication in Python3:

  
      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-from-panel"
      # Put the proxy and reCaptcha token data
      Captcha_dict = {
          'proxy': 'http://user:password@127.0.0.1:1234',
          'proxytype': 'HTTP',
          'googlekey': '6Lc2fhwTAAAAAGatXTzFYfvlQMI2T7B6ji8UVV_f',
          'pageurl': 'http://google.com'}
      # Create a json string
      json_Captcha = json.dumps(Captcha_dict)
      client = deathbycaptcha.SocketClient(username, password, authtoken)
      # to use http client client = deathbycaptcha.HttpClient(username, password)
      # client = deathbycaptcha.HttpClient(username, password, authtoken)
      try:
          balance = client.get_balance()
          print(balance)
          # Put your CAPTCHA type and Json payload here:
          captcha = client.decode(type=4, token_params=json_Captcha)
          if captcha:
              # The CAPTCHA was solved; captcha["captcha"] item holds its
              # numeric ID, and captcha["text"] item its list of "coordinates".
              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")
  # Repeat for other CAPTCHAs
  

Using token authentication in Python2:

  
      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-from-panel"
      # Put the proxy and reCaptcha token data
      captcha_dict = {
          'proxy': 'http://user:password@127.0.0.1:1234',
          'proxytype': 'HTTP',
          'googlekey': '6Lc2fhwTAAAAAGatXTzFYfvlQMI2T7B6ji8UVV_b',
          'pageurl': 'http://google.com'}
      # Create a json string
      json_captcha = json.dumps(captcha_dict)
      # to use socket client
      client = deathbycaptcha.SocketClient(username, password, authtoken)
      # to use http client
      # client = deathbycaptcha.HttpClient(username, password, authtoken)
      try:
          balance = client.get_balance()
          print(balance)
          # Put your CAPTCHA type and Json payload here:
          captcha = client.decode(type=4, token_params=json_captcha)
          if captcha:
                  # The CAPTCHA was solved; captcha["captcha"] item holds its
                  # numeric ID, and captcha["text"] item its list of "coordinates".
              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"
  # Repeat for other CAPTCHAs
  

Using token authentication in NodeJs:

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

    const username = 'username';     // DBC account username
    const password = 'password';     // DBC account password
    // if using username/password, authtoken must be an empty string
    // authentication token can be enabled in user panel
    const authtoken = 'token-from-panel'; //DBC account authtoken

    // Proxy and Recaptcha token data
    const token_params = JSON.stringify({
      'proxy': 'http://username:password@proxy.example:3128',
      'proxytype': 'HTTP',
      'googlekey': '6Lc2fhwTAAAAAGatXTzFYfvlQMI2T7B6ji8UVV_f',
      'pageurl': 'http://google.com'
    });

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

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

    // Solve captcha with type 4 & token_params extra arguments
    client.decode({extra: {type: 4, token_params: token_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);
        // });
      }

    });
  // Repeat for other CAPTCHAs
  

Using token authentication in Java:

  
    import com.DeathByCaptcha.AccessDeniedException;
    import com.DeathByCaptcha.Client;
    import com.DeathByCaptcha.HttpClient;
    import com.DeathByCaptcha.SocketClient;
    import com.DeathByCaptcha.Captcha;
    import java.io.IOException;

    class ExampleSimple
    {
        public static void main(String[] args)
            throws Exception
        {
            // Put your DBC username & password || authtoken here:
            // if the number of arguments is two we are using authtoken
            // if the number of arguments is three we are using username/password combination
            System.out.println(args.length);
            Client client;
            // using http API
            /*
            if(args.length == 3){
                client = (Client)(new HttpClient(args[0], args[1]));
            }else if(args.length == 2){
                client = (Client)(new HttpClient(args[0]));
            }else{
                System.out.println("Wrong number of arguments");
                System.out.println("You must use username/password combination");
                System.out.println("Or API key");
                return;
            }
            */
            // using sockets API
            if(args.length == 3){
                client = (Client)(new SocketClient(args[0], args[1]));
            }else if(args.length == 2){
                client = (Client)(new SocketClient(args[0]));
            }else{
                System.out.println("Wrong number of arguments");
                System.out.println("You must use username/password combination");
                System.out.println("Or API key");
                return;
            }
            client.isVerbose = true;

            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 {
                    // Upload a CAPTCHA and poll for its status with 120 seconds timeout.
                    // Put you CAPTCHA image file name, file object, input stream, or
                    // vector of bytes, and optional solving timeout (in seconds) here.
                    if (args.length == 3){
                        captcha = client.decode(args[2], 120);
                    }else if (args.length == 2){
                        captcha = client.decode(args[1], 120);
                    }else{
                        System.out.println("Failed uploading CAPTCHA - args");
                        return;
                    }
                } 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);
            }
        }
    }

  // Repeat for other CAPTCHAs
  

Using token authentication in Perl:

  
      #!/usr/bin/env perl

      use strict;
      use warnings;
      use lib '.';
      use DeathByCaptcha::HttpClient;
      use DeathByCaptcha::SocketClient;


      my ($username, $password, $filename) = @ARGV;

      # Put your DeathByCaptcha username & password here:
      # if using authtoken authentication username must be "authtoken"
      # and $password must be the authtoken from user panel
      # using authtoken in user panel disables username/password authentication
      my $client = DeathByCaptcha::HttpClient->new($username, $password);
      # my $client = DeathByCaptcha::SocketClient->new($username, $password);

      printf("Your balance is %f US cents\n", $client->getBalance());

      if ($filename) {
        printf("Provided captcha: $filename \n");
        # Put your CAPTCHA image file name and desired solving timeout (in seconds) here:
        my $captcha = $client->decode($filename, +DeathByCaptcha::Client::DEFAULT_TIMEOUT);
        if (defined $captcha) {
            print "CAPTCHA " . $captcha->{"captcha"} . " solved: " . $captcha->{"text"} . "\n";

            # Report if the CAPTCHA was solved incorrectly.
            # Make sure it was in fact solved incorrect, do not just report every
            # CAPTCHA, or you'll get banned as abuser.
            # $client->report($captcha->{"captcha"});
        }
      } else {
        printf("No captcha provided \n");
      }
  // Repeat for other CAPTCHAs