এপিআই
অটোমেশনের উদ্দেশ্যে, ডেথ বাই ক্যাপচা (DBC) ব্যবহারকারী এবং ডেভেলপারদের যেকোন প্রদত্ত সফ্টওয়্যারের সাথে একীভূত করার জন্য API প্রদান করে।
সমাধান প্রক্রিয়া নিম্নরূপ হয়:
আপনার প্রিয় টুল(গুলি) এবং/অথবা প্রোগ্রামিং ভাষা ব্যবহার করে DBC বাস্তবায়নের জন্য অতিরিক্ত তথ্য ও সংস্থানগুলির জন্য নীচে আমাদের API বিশদ দেখুন!
সংস্করণ: 4.6
- .NET (C#, Visual Basic)
- C# Selenium
- AutoIt3
- iMacros
- C (ক্লায়েন্ট এবং libগুলির উত্স কোড)
- Java
- Maven
- Java Selenium
- Perl 5+
- PHP v5+
- Python v2.5+ and v3.0+
- পিওয়াইপিআই থেকে পাইথন 3 ক্লায়েন্ট লাইব্রেরি
- Python3 Selenium
- Node.js v8.12.0+
- NodeJS Selenium
- জন্য কমান্ড-লাইন সরঞ্জাম Windows, Linux (i386 and x86-64) (নীচে দেখুন ব্যবহার নোট)
তৃতীয় পক্ষের ক্লায়েন্ট
- পাঠ্য সহ সাধারণ চিত্র ক্যাপচা (কেস সংবেদনশীল ক্যাপচা, গণিত ক্যাপচা ইত্যাদি সহ)
- ReCAPTCHA by Token API ( reCAPTCHA V2, V3, Invisible & Enterprise BETA )
- Geetest Challenges
- FunCaptcha
- KeyCaptcha নতুন BETA
- TextCAPTCHA নতুন BETA
- Cloudflare Turnstile নতুন BETA
- Audio Captcha নতুন BETA
- Lemin Cropped নতুন BETA
- Capy Puzzle! নতুন BETA
- Amazon WAF নতুন BETA
- Cyber Siara নতুন BETA
- Mtcaptcha নতুন BETA
- Cutcaptcha নতুন BETA
- Friendly Captcha নতুন BETA
- Datadome নতুন BETA
- Funcaptcha by Image নতুন BETA
- Tencent নতুন BETA
- Atb Captcha নতুন BETA
- Support for legacy/outdated reCAPTCHA solving via Coordinates or Image Group
We are using command line dotnet 6+
Make sure you already downloaded selenium browser driver
and double check the driver executable is on PATH
You can use ChromeDriver for Chrome or Geckodriver for Firefox
and can switch between these drivers on the C# source code.
Download C# Selenium project from the list above
Edit Program.cs and put your credentials there
string _username = "DBC_USERNAME";
string _password = "DBC_PASSWORD";
In the folder where .csproj file is located
Do the following comands to run the example:
dotnet restore to install the requirements
dotnet build to build the project
dotnet run to run the project
dotnet clean to clean the project
// Repeat for other CAPTCHAs
We are using Maven 3.6+
Make sure you already downloaded selenium browser driver
and double check the driver executable is on PATH
You can use ChromeDriver for Chrome or Geckodriver for Firefox
and can switch between these drivers on the Java source code.
Download Java Selenium project from the list above
Edit App.java and put your credentials there
Client client = new HttpClient("DBC_USERNAME", "DBC_PASSWORD");
In the folder where pom.xml file is located
Do the following comands to run the example:
mvn clean install -U to clean project and install dependencies
mvn exec:java -Dexec.mainClass="deathbycaptcha.App" to build the project
mvn clean to clean the project
Refer to Java and Maven project examples to more detail
We are using NodeJS v12+
Make sure you already downloaded selenium browser driver
and double check the driver executable is on PATH
You can use ChromeDriver for Chrome or Geckodriver for Firefox
and can switch between these drivers on the NodeJS source code.
Download NodeJS Selenium project from the list above
Edit nodeSeleniumExample.js and put your credentials there
const USERNAME = 'DBC_USERNAME' // Your DBC username here
const PASSWORD = 'DBC_PASSWORD' // Your DBC password here
In the folder where package.json file is located
Do the following comands to run the example:
npm install // to install dependencies
node recaptcha_example/nodeSeleniumExample.js // to run the example
Refer to NodeJS project examples to more detail
We are using Python v3+
Make sure you already downloaded selenium browser driver
and double check the driver executable is on PATH
You can use ChromeDriver for Chrome or Geckodriver for Firefox
and can switch between these drivers on the Python3 source code.
Download Python3 Selenium project from the list above
Edit python_selenium_example.py and put your credentials there
USERNAME = 'DBC_USERNAME' # Your DBC username here
PASSWORD = 'DBC_PASSWORD' # Your DBC password here
In the folder where requirements.txt file is located
Do the following comands to run the example:
python3 -m venv venv to create a new python3 venv
. venv/bin/activate to activate the venv
pip3 install -r requirements.txt to install dependencies
python3 python_selenium_example.py
Refer to Python3 project examples to more detail
Create new Python3 virtual environment
python3 -m venv venv
Activate the virtual environment
. venv/bin/activate
Install DeathByCaptcha library from pypi
pip install deathbycaptcha-official
Create our python3 script
import deathbycaptcha
# don't forget to import deathbycaptcha library
username = 'username'
password = 'password'
authtoken = ''
...
use the DeathByCaptcha python http client
http_client = deathbycaptcha.HttpClient(username, password, authtoken)
or use the DeathByCaptcha python sockets client
socket_client = deathbycaptcha.SocketClient(username, password, authtoken)
Refer to Python3 project examples to more detail.
Create new Maven project
mvn archetype:generate
-DgroupId=examples
-DartifactId=deathbycaptcha-examples
-DarchetypeArtifactId=maven-archetype-quickstart
-DarchetypeVersion=1.4
-DinteractiveMode=false
Include the following dependencies on maven pom.xml file
<dependencies>
<dependency>
<groupId>io.github.deathbycaptcha</groupId>
<artifactId>deathbycaptcha-java-library</artifactId>
<version>0.43</version>
</dependency>
</dependencies>
if the pom.xml is correct.
We can use the imports on our java files.
import com.DeathByCaptcha.AccessDeniedException;
import com.DeathByCaptcha.Client;
import com.DeathByCaptcha.HttpClient;
import com.DeathByCaptcha.SocketClient;
import com.DeathByCaptcha.Captcha;
...
Clean and build the project
mvn clean install -U
Run the project
mvn exec:java -Dexec.mainClass="examples.GetBalance" -Dexec.args=""
mvn exec:java -Dexec.mainClass="examples.ExampleFuncaptcha"
mvn exec:java -Dexec.mainClass="examples.ExampleCaptcha"
mvn exec:java -Dexec.mainClass="examples.ExampleRecaptchaV2"
...
Refer to Java and Maven project examples to more detail
সকেট এপিআই ক্লায়েন্টগুলি ব্যবহার করার সময়, নিশ্চিত হয়ে নিন যে আপনার পোর্টগুলিতে 8123-8130 ফায়ারওয়ালড পোর্টগুলিতে বহির্গামী টিসিপি সংযোগ রয়েছে। যদি সকেট এপিআই ক্লায়েন্টগুলি আপনার পক্ষে কাজ না করে তবে এইচটিটিপি এপিআই ক্লায়েন্টগুলি ব্যবহার করুন। 8123-8130 পোর্টস রেঞ্জটি কেবল সকেট এপিআইয়ের জন্য, এটি http এপিআই দিয়ে ব্যবহার করার চেষ্টা করবেন না!
নোট করুন যে ডিকোড ফাংশন/পদ্ধতিতে একটি কল ক্যাপচা সমাধানের আগে সময়সীমা পৌঁছে গেলে একটি নাল মান ফেরত দিতে পারে। যদি এটি প্রায়শই ঘটে থাকে তবে ব্যবহৃত সময়সীমা বাড়ান।
আরও তথ্যের জন্য প্রতিটি এপিআই ক্লায়েন্ট প্যাকেজের অন্তর্ভুক্ত উদাহরণগুলি দেখুন এবং ক্লায়েন্ট উত্স কোডটি পরীক্ষা করুন।
- আপনার ভারসাম্য পরীক্ষা করতে, চালান:
deathbycaptcha.exe -l USERNAME -p PASSWORD -b
বা প্রমাণীকরণ টোকেন ব্যবহার করেdeathbycaptcha.exe -a AUTHTOKEN -b
আপনার ভারসাম্য <কোড> ব্যালেন্স.টেক্সট কোড> ফাইলটিতে সংরক্ষণ করা হবে এবং স্ট্যান্ডার্ড আউটপুটে মুদ্রিত হবে। - ক্যাপচা আপলোড করতে, চালান:
deathbycaptcha.exe -l USERNAME -p PASSWORD -c CAPTCHA_FILE_NAME [-t TIMEOUT]
বা প্রমাণীকরণ টোকেন ব্যবহার করেdeathbycaptcha.exe -a AUTHTOKEN -c CAPTCHA_FILE_NAME [-t TIMEOUT]
ডিফল্ট ক্যাপচা সমাধানের সময়সীমা 60 সেকেন্ড।
যদি সমাধান করা হয় তবে ক্যাপচা আইডি <কোড> আইডি.টিএক্সটি কোড> এ সংরক্ষণ করা হবে, ক্যাপচা পাঠ্যটি <কোড> উত্তর.টেক্সট কোড> এ সংরক্ষণ করা হবে এবং আইডি এবং পাঠ্য উভয়ই মুদ্রিত হবে স্ট্যান্ডার্ড আউটপুট একটি স্থান দ্বারা পৃথক। - একটি ভুলভাবে সমাধান করা ক্যাপচা রিপোর্ট করতে, রান:
deathbycaptcha.exe -l USERNAME -p PASSWORD -n CAPTCHA_ID
বা প্রমাণীকরণ টোকেন ব্যবহার করেdeathbycaptcha.exe -a AUTHTOKEN -n CAPTCHA_ID
আপনার নিজের বাস্তবায়নের আগে Death By Captcha এইচটিটিপি এপিআই ক্লায়েন্ট, দয়া করে উপরে তালিকাভুক্ত আমাদের অফিসিয়াল ক্লায়েন্টগুলির সাথে সকেট এপিআই ব্যবহার করার বিষয়টি গুরুত্ব সহকারে বিবেচনা করুন।
এপিআই ইউআরএল হয় http://api.dbcapi.me/api/
.
ইউআরএল পাথ কাঙ্ক্ষিত ক্রিয়াকলাপের উপর নির্ভর করে পরিবর্তনগুলি। এপিআই -তে করা অনুরোধের সমস্ত প্রতিক্রিয়াগুলির দুটি সাধারণ ক্ষেত্র রয়েছে:
status
— অনুরোধ স্থিতি। 0 যদি অভ্যন্তরীণ অনুরোধ প্রক্রিয়াজাতকরণের সময় কোনও ত্রুটি না থাকে তবে অন্যথায় 255।error
— ঘটনার ত্রুটির সংক্ষিপ্ত ব্যাখ্যা। যখন স্থিতি 255 হয় তখনই ফিরে আসে।
সঠিক URL পাথ এবং নির্দিষ্ট ক্রিয়াকলাপের জন্য অন্যান্য প্রত্যাবর্তিত ক্ষেত্রগুলি সম্পর্কে বিশদগুলির জন্য, নীচের বিভাগটি দেখুন।
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.
"সাধারণ ক্যাপচা" চ্যালেঞ্জ কি?
ক্যাপচা-এর এই ফর্মটি ইমেজ-ভিত্তিক এবং একটি বিকৃত ইমেজ থেকে অক্ষর বা সংখ্যার ক্রম লিখতে হবে
ক্যাপচা আপলোড করতে, একটি multipart/form-data
POST অনুরোধ প্রেরণ করুন http://api.dbcapi.me/api/captcha
.
অনুরোধে অবশ্যই নিম্নলিখিত ক্ষেত্রগুলি থাকতে হবে:
username
— আপনার Death By Captcha ব্যবহারকারীর নাম।password
— আপনার Death By Captcha পাসওয়ার্ড।captchafile
— ক্যাপচা চিত্র।
আপনি যদি টোকেন প্রমাণীকরণ ব্যবহার করছেন:
authtoken
— আপনার Death By Captcha প্রমাণীকরণ টোকেন।captchafile
— ক্যাপচা চিত্র।
captchafile
কাচা CAPTCHA চিত্র ফাইল বা base64:
প্রিফিক্স সংযুক্ত করে base64
-encoded CAPTCHA চিত্র হতে হবে। চিত্র ফাইলের আকার সীমাবদ্ধ হবে 180 KB এর কম। যখন চিত্রটি Base64 দ্বারা এনকোড করা হবে, তখন আকারটি 120 KB এর কম হতে হবে। সমর্থিত চিত্র ফরম্যাটগুলি হলে JPG, PNG, GIF এবং BMP।
এখানে এইচটিএমএল ফর্ম যা কৌশলটি করে:
<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>
বা টোকেন প্রমাণীকরণ ব্যবহার করে:
<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>
এখানে কার্ল কমান্ড সমতুল্য:
curl --header 'Expect: ' -F username=YOUR_USERNAME -F password=YOUR_PASSWORD -F captchafile=@YOUR_CAPTCHA_FILENAME http://api.dbcapi.me/api/captcha
বা টোকেন প্রমাণীকরণ ব্যবহার করে:
curl --header 'Expect: ' -F authtoken=YOUR_AUTHTOKEN -F captchafile=@YOUR_CAPTCHA_FILENAME http://api.dbcapi.me/api/captcha
base64
-আকোডেড captchafile
ক্ষেত্রটি এর মতো দেখা উচিত:
base64:R0lGODlhAQABAIABAAAAAP///yH5BAEAAAEALAAAAAABAAEAAAICTAEAOw==
আপনি নিম্নলিখিত এইচটিটিপি প্রতিক্রিয়াগুলির একটি পাবেন:
-
303 See Other
যদি আপনার ক্যাপচা সফলভাবে আপলোড করা হয়,অবস্থান
এইচটিটিপি শিরোনাম আপনাকে আপলোড করা ক্যাপচা স্থিতি পৃষ্ঠায় নির্দেশ করবে, আপনিঅবস্থান
থেকে অনুসরণ করতে পারেন আপলোড করা ক্যাপচা স্থিতি পান। এছাড়াও, নিম্নলিখিত ক্ষেত্রগুলি ফিরে আসবে:
captcha
— আপলোড ক্যাপচা আইডি।is_correct
— 1 যদি এই ক্যাপচাটির জন্য কোনও উত্তর চিহ্নিত করা হয় বা এটি এখনও প্রক্রিয়া করা হচ্ছে, 0 যদি প্রক্রিয়াজাতকরণ শেষ হয় এবং কোনও উত্তর পাওয়া যায় না।text
— ক্যাপচা উত্তর। একটি খালি স্ট্রিং মানে ক্যাপচা এখনও সমাধান করা হয়নি।
status=0&captcha=123&is_correct=1&text=
Json এনকোডেড উদাহরণ:{ "status": 0, "captcha": 123, "is_correct": 1, "text": "" }
-
403 Forbidden
যদি আপনার Death By Captcha শংসাপত্রগুলি প্রত্যাখ্যান করা হয়, বা আপনার কাছে পর্যাপ্ত ক্রেডিট নেই। -
400 Bad Request
যদি আপনার অনুরোধটি উপরের স্পেসিফিকেশনটি অনুসরণ না করে, বা ক্যাপচা বৈধ চিত্র না হওয়ার জন্য প্রত্যাখ্যান করা হয়েছিল। -
500 Internal Server Error
আমাদের পাশে যদি কিছু ঘটে থাকে তবে আপনাকে ক্যাপচা আপলোড করতে বাধা দেয়; আপনি যদি নিশ্চিত হন যে আপনি বৈধ ক্যাপচা চিত্রগুলির সাথে সঠিকভাবে কাঠামোগত অনুরোধগুলি প্রেরণ করছেন তবে সমস্যাটি অব্যাহত রয়েছে তবে দয়া করে আমাদের লাইভ সাপোর্টের সাথে যোগাযোগ করুন এবং কীভাবে সমস্যাটি পুনরুত্পাদন করবেন তা বিশদগুলিতে তাদের জানান। -
503 Service Temporarily Unavailable
যখন আমাদের পরিষেবাটি অতিরিক্ত বোঝা হয়ে যায়, পরে আবার চেষ্টা করুন।
এই মুহুর্তে আপনি যা CAPTCHA সহাইল করেছেন তা এখনও সমাধান করা হয়নি! যদি আপনি সার্ভার প্রতিক্রিয়ার text কীতে উত্তর পেয়ে না থাকেন তবে আপনাকে এর জন্য পোল করতে হবে। বিস্তারিত জানতে আপলোড করা CAPTCHA এর স্থিতির জন্য পোলিং করুন।
আপলোড করা ক্যাপচাসের স্থিতি পেতে, একটি জিইটি অনুরোধ জারি করুন
http://api.dbcapi.me/api/captcha/%CAPTCHA_ID%
,
যেখানে %CAPTCHA_ID%
ক্যাপচা আপলোড করার সময় আপনার আপলোড করা ক্যাপচা আইডি নেওয়া হয় যা ক্যাপচা আপলোড করতে সময় অর্জন করা হয়েছে.
আপনাকে এবার আপনার Death By Captcha শংসাপত্র সরবরাহ করতে হবে না।
প্রতিক্রিয়াটি একটি HTTP 200 OK
প্রতিক্রিয়া হবে এবং ক্যাপচা আপলোড করা বিভাগের 303 অন্য দেখুন
প্রতিক্রিয়ার জন্য বর্ণিত একই ফিল্ডগুলি থাকবে।
যদি ক্যাপচা এখনও সমাধান না করা হয় তবে text
কী খালি আসবে। এই উত্তরের জন্য আপনাকে পোলিং চালিয়ে যেতে হবে। উদাহরণ প্রতিক্রিয়া:
-
সঠিকভাবে সমাধান করা ক্যাপচা এর ইউআরএল-এনকোডেড প্রতিক্রিয়া
status=0&captcha=1234&is_correct=1&text=tyrone+slothrop
-
সঠিকভাবে সমাধান করা ক্যাপচা এর জেএসএন-এনকোডেড প্রতিক্রিয়া
{ "captcha": 1234, "is_correct": true,"status": 0, "text": "tyrone slothrop" }
-
একটি ভুলভাবে সমাধান করা ক্যাপচা এর জেএসএন-এনকোডেড প্রতিক্রিয়া
{ "captcha": 1234, "is_correct": false, "status": 0, "text": "?" }
-
একটি অবিচ্ছিন্ন ক্যাপচা এর জেএসএন-এনকোডেড প্রতিক্রিয়া
{ "captcha": 0, "status": 0 }
আপনি যদি এই প্রতিক্রিয়াটি পান তবে নিশ্চিত করুন যে আপনি উত্তরের জন্য পোল করার জন্য যে ক্যাপচা আইডি ব্যবহার করছেন তা আপলোড করার সময় একই ফিরে আসে। যদি সমস্যাটি অব্যাহত থাকে তবে নির্দ্বিধায় আমাদের সাথে যোগাযোগ করুন।
দয়া করে কয়েক সেকেন্ডের মধ্যে একাধিকবার ক্যাপচা স্ট্যাটাসের জন্য পোল ডোন্ট পোল.
এটি অপমানজনক হিসাবে বিবেচিত এবং আপনাকে নিষিদ্ধ করতে পারে।
আপনার এবং আমাদের ব্যান্ডউইথ সংরক্ষণ করুন।
আপনি যদি ভাবেন যে আপনার ক্যাপচা ভুলভাবে সমাধান করা হয়েছে, তবে আপনার অর্থ ফেরত পেতে এটি Death By Captcha এ রিপোর্ট করুন।
এটি করার জন্য, http://api.dbcapi.me/api/captcha/%CAPTCHA_ID%/report
নিম্নলিখিত ক্ষেত্রগুলির সাথে একটি পোস্ট অনুরোধ জারি করুন:
username
— আপনার Death By Captcha ব্যবহারকারীর নাম।password
— আপনার Death By Captcha পাসওয়ার্ড।
বা প্রমাণীকরণ টোকেন ব্যবহার করে:
authtoken
— আপনার Death By Captcha প্রমাণীকরণ টোকেন।
প্রতিক্রিয়া হবে:
200 OK
যদি রিপোর্ট শেষ হয়। এই ক্ষেত্রে, আপনার ক্রেডিটগুলি ফেরত দেওয়া হবে। প্রতিক্রিয়া বডিটি পোলের মতো একই হবে (বা আপলোড) তবেis_correct
ক্ষেত্রটি 0 হবে 0 উদাহরণ:{ "captcha": 1234, "is_correct": false,"status": 0, "text": "tyrone slothrop" }
503 Service Unavailable
যদি রিপোর্ট শেষ করা যায় না। এটি হতে পারে কারণ:
1) প্রদত্ত আইডির সাথে সম্পর্কিত ক্যাপচা ব্যবহারকারীর প্রতিবেদন দ্বারা আপলোড করা হয়নি;
2) আপনার ব্যবহারকারী নিষিদ্ধ করা হয়েছে;
3) প্রতিবেদনটি এক ঘন্টারও বেশি সময় করা হয়েছিল পরে যদি আপলোড করা হয়। এই ক্ষেত্রে, আপনাকে ফেরত দেওয়া হবে না।
এই বৈশিষ্ট্যটি গালি দেওয়া আপনাকে নিষিদ্ধ করবে!
আপনার ক্রেডিট ভারসাম্য পরীক্ষা করতে, http://api.dbcapi.me/api
নিম্নলিখিত ক্ষেত্রগুলির সাথে একটি জিইটি বা পোস্ট অনুরোধ জারি করুন:
username
— আপনার Death By Captcha ব্যবহারকারীর নাম।password
— আপনার Death By Captcha পাসওয়ার্ড।
বা প্রমাণীকরণ টোকেন ব্যবহার করে:
authtoken
— আপনার Death By Captcha প্রমাণীকরণ টোকেন।
সফল প্রমাণীকরণের পরে, আপনি আপনার Death By Captcha ক্যাপচা অ্যাকাউন্টের বিস্তারিত, ইউআরএল বা জেসন-এনকোডেড হিসাবে, নিম্নলিখিত ক্ষেত্রগুলির সাথে 200 OK
প্রতিক্রিয়া পাবেন:
user
— আপনার Death By Captcha অ্যাকাউন্ট আইডি;rate
— আমরা আপনাকে কতটা চার্জ করি করি সঠিকভাবে সমাধান করা একটি CAPTCHA এর জন্য, US¢ এ;balance
— আপনার বর্তমান ক্রেডিট ব্যালেন্স, US¢ এ।is_banned
— 1 যদি ব্যবহারকারীকে নিষিদ্ধ করা হয় তবে 0 না থাকলে।
উদাহরণ json- এনকোডেড প্রতিক্রিয়া:
{ "is_banned": false, "status": 0, "rate": 0.139,"balance": 455.23, "user": 43122 }
বর্তমান সার্ভারের স্থিতি পাওয়ার জন্য, http://api.dbcapi.me/api/status
এ জিইটি অনুরোধ জারি করুন। প্রতিক্রিয়া নিম্নলিখিত ক্ষেত্র আছে:
todays_accuracy
— শতাংশে নির্ভুলতার প্রতিনিধিত্বকারী সংখ্যা (উদাঃ, 99.6 99.6%প্রতিনিধিত্ব করে)solved_in
— সেকেন্ডে গড় সমাধানের সময়is_service_overloaded
— 1 যদি পরিষেবা ওভারলোড হয় তবে 0 অন্যথায় 0
উদাহরণ json- এনকোডেড প্রতিক্রিয়া:
{ "status": 0, "todays_accuracy": 99.9, "solved_in": 5.3,"is_service_overloaded": false }
- DeCaptcher API (উভয় সকেট এবং এইচটিটিপি)
- Antigate (Anti-Captcha)
- 2captcha