指数

API客户libs
Turnstile
- FAQ
- 代码示例

下载基于API客户端的示例代码：

Python v3

新的旋转门API支持

“Cloudflare Turnstyle”挑战是什么？

是Cloudflare制造的Captha。他们面临的挑战通常要求用户对齐并单击某些图像。

为了方便您使用，我们已经实现了对Turnstile API的支持。如果您的软件可以与之配合，并支持最小配置，则应该可以立即使用Death By Captcha解码Turnstile。

Turnstile API: 提供站点URL和旋转门站点密钥，API返回一个令牌，您将使用该令牌提交带有旋转门挑战的页面上的表单。

价钱

目前价格为$2.89/1K成功解决的旋转门挑战。旋转门被报告为错误解决的情况下，您将不会被收费。请注意，此定价仅适用于新的旋转门挑战，因此只有使用此特定API的客户将被收取该费率。

旋转门API常见问题解答：

Turnstile API URL是什么？: 要使用旋转门API，您需要向http://api.dbcapi.me/api/captcha发送HTTP POST请求

旋转门API的POST参数是什么？

username: 您的DBC帐户用户名
password: 您的DBC帐户密码
type=12: 类型12指定这是一个旋转门API
turnstile_params=json(payload): 访问旋转门挑战所需的数据

proxy: 您的代理URL和凭据（如果有）。例证：
- http://127.0.0.1:3128
- http://user:password@127.0.0.1:3128
proxytype: 您的代理连接协议。有关支持的代理类型，请参见支持哪些代理类型？示例：
- HTTP
sitekey: 带有旋转门的网站的旋转门站点密钥。
例子：
- 0x4AAAAAAAGlwMzq_9z6S9Mh
您需要找到旋转门的站点密钥。您可以找到旋转门的DIV元素，并在JavaScript代码中检查Data-SiteKey参数的值或SiteKey属性。另外，该站点可以在验证码的iFrame的URL中找到。
pageurl: 包含旋转门挑战的页面的URL。此URL必须包括加载旋转门的路径。例如：如果您要解决的旋转门在http://test.com/path1中，则pageurl必须是http://test.com/path1，而不是http://test.com。
action (选修的): 页面上找到的可选操作参数的值可以在data-action属性中定义或传递给turnstile.render调用。

代理参数是可选的，但是我们强烈建议使用一个解决方案的IP之间的不一致之处，以防止提供的页面拒绝（如果没有提供代理）和提交的IP验证解决方案（您的）。

注意：

turnstile_params的完整示例：


{
    'proxy': 'http://user:password@127.0.0.1:1234',
    'proxytype': 'HTTP',
    'sitekey': '0x4AAAAAAAGlwMzq_9z6S9Mh',
    'pageurl': 'https://testsite.com/xxx-test'
}

带有可选参数动作的turnstile_params的完整示例：


{
    'proxy': 'http://user:password@127.0.0.1:1234',
    'proxytype': 'HTTP',
    'sitekey': '0x4AAAAAAAGlwMzq_9z6S9Mh',
    'pageurl': 'https://testsite.com/xxx-test',
    'action': 'action'
}

Turnstile API的响应是什么？

Turnstile API响应具有以下结构。它有效一次使用，并具有2分钟的寿命。它将是以下字符串之一：


"0.Ja5ditqqMhsYE6r9okpFeZVg6ixDXZcbSTzxypXJkAeN-D-VxmNaEBR_XfsPG
k-nxhJFUwMERSIXk6npwAifIYfKuP5AZHeLgCAm0W6CAyJlc9WvO_t7pGYnR_wwb
yUyroooPkOI9mfHeeXb1urRmsTF_kP5pU5kQ05OVx3EyuXK3nl0fd4y1u7SyYThi
zoKRYkLz1MOI4fHm1PHEyax3SC_IZArT2r-Uc3SXNCKj1hP-WZ3BYlRvsY5e2tUam
K5cwSEqAA18u-zn0eAYJHvhqtMa3EvtQ5Q7lhLSL9JW6MOlau0uAzNmoes9yKp2Kb
6RifIyYx167waZnhSSpfFedVO3wRFtlT8AGO4ZAG1Yu60k7PIO9V8YM8s7XRCPZQ1
GEC7tWnRkPsLUqePHr1LA8GgetzbN2VxeB4.4qK44t57wfzV9awhcNrrJQ.22d19e
310e5d9f4123c5b9d52eaed2e4c4b179054eee2dd99147759975a7ab36"

使用与目标网站的交互中返回的令牌。通常，令牌通过名称为“cf-turnstile-response”的输入发送，或者在启用reCAPTCHA兼容模式时，也会在名称为“g-recaptcha-response”的输入中发送。还可以通过在turnstile.render调用或data-callback属性内定义的回调函数来处理令牌。

支持哪些代理类型？

当前，仅支持 http 代理。对其他类型的支持将来会添加。

如何与API客户端一起使用Turnstile API：


    /**
     * Death by Captcha PHP API turnstile 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 turnstile token data
    $data = array(
        'proxy' => 'http://user:password@127.0.0.1:1234',
        'proxytype' => 'HTTP',
        'sitekey' => '0x4AAAAAAAGlwMzq_9z6S9Mh',
        'pageurl' => 'https://clifford.io/demo/cloudflare-turnstile'
    );
    //Create a json string
    $json = json_encode($data);

    //Put the type and the json payload
    $extra = [
        'type' => 12,
        'turnstile_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']);
        }
    }


    # turnstile
    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 turnstile data
    Captcha_dict = {
        'proxy': 'http://user:password@127.0.0.1:1234',
        'proxytype': 'HTTP',
        'sitekey': '0x4AAAAAAAGlwMzq_9z6S9Mh',
        'pageurl': 'https://clifford.io/demo/cloudflare-turnstile'
    }

    # 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=12, turnstile_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 ExampleTurnstile {
        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 turnstile data
                    String proxy = "http://user:password@127.0.0.1:1234";
                    String proxytype = "http";
                    String sitekey = "0x4AAAAAAAGlwMzq_9z6S9Mh";
                    String pageurl = "https://clifford.io/demo/cloudflare-turnstile";
                    /* Upload a turnstile 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. */
                    captcha = client.decode(12, proxy, proxytype, sitekey, pageurl);

                    //other method is to send a json with the parameters
                    /*
                    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(12, 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);
            }


        }
    }


    // turnstile

    using System;
    using System.Collections;
    using DeathByCaptcha;

    namespace DBC_Examples.examples
    {
        public class Turnstile Example
        {
            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:password@127.0.0.1:1234";
                string proxyType = "HTTP";
                string sitekey = "0x4AAAAAAAGlwMzq_9z6S9Mh";
                string pageurl = "https://clifford.io/demo/cloudflare-turnstile";

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

                    /* Upload a CAPTCHA and poll for its status. Put the Turnstile
                       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", 12},
                            {"turnstile_params", turnstileParams}
                        });

                    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 Turnstile
        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 turnstile data
            Dim proxy = "http://user:password@127.0.0.1:1234"
            Dim proxyType = "HTTP"
            Dim sitekey = "0x4AAAAAAAGlwMzq_9z6S9Mh"
            Dim pageurl = "https://clifford.io/demo/cloudflare-turnstile"

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

            ' Create a JSON with the extra data
            Dim turnstileParams = "{""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", 12)
            extraData.Add("turnstile_params", turnstileParams)

            ' Upload a CAPTCHA and poll for its status.  Put the Turnstile
            ' 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 turnstile 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 turnstile token data
    const turnstile_params = JSON.stringify({
        'proxy': 'http://username:password@proxy.example:3128',
        'proxytype': 'HTTP',
        'sitekey': '0x4AAAAAAAGlwMzq_9z6S9Mh',
        'pageurl': 'https://clifford.io/demo/cloudflare-turnstile'
    });

    // 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 12 & turnstile_params extra arguments
    client.decode({extra: {type: 12, turnstile_params: turnstile_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);
            * });
            */
        }

    });

指数

下载基于API客户端的示例代码：

新的旋转门API支持

“Cloudflare Turnstyle”挑战是什么？

价钱

旋转门API常见问题解答：

如何与API客户端一起使用Turnstile API：

更新

支持

现场支持

关于我们

接触

Death By Captcha