Bỏ qua hình ảnh xác thực trong JAVA
Triển khai thư viện Java để bỏ qua xác minh captcha nhanh chóng. API đơn giản để giải mã xác thực.
Gói Java để dễ dàng tích hợp với API của 2Captcha dịch vụ giải mã captcha để bỏ qua recaptcha , funcaetptest, <solve_geuncaptest> và giải quyết bất kỳ hình ảnh xác thực nào khác</solve_geuncaptest>
Bắt đầu nhanhCài đặt
Gói tập lệnh có thể được cài đặt bằng trình cài đặt gói hoặc theo cách thủ công
Kho lưu trữ Trung tâm Maven
Phần mềm 2captcha-java có sẵn trong Maven Central
Chúng tôi mời bạn khám phá kho lưu trữ GitHub của chúng tôi, nơi bạn có thể tìm thấy các thư viện và mô-đun cho tích hợp dễ dàng với API của chúng tôi.
Cấu hình
Mô tả tất cả các thông số cần thiết để cấu hình gói đã cài đặt
Một phiên bản của lớp TwoCaptcha
có thể được tạo như sau:
TwoCaptcha solver = new TwoCaptcha('YOUR_API_KEY');
Bạn cũng có thể tùy chỉnh một số tùy chọn cho phiên bản đã tạo:
solver.setSoftId(123);
solver.setCallback("https://your.site/result-receiver");
solver.setDefaultTimeout(120);
solver.setRecaptchaTimeout(600);
solver.setPollingInterval(10);
Tùy chọn phiên bản TwoCaptcha
Lựa chọn | Giá trị mặc định | Sự mô tả |
---|---|---|
softId | - | ID phần mềm của bạn nhận được sau khi xuất bản trong 2Captcha danh mục phần mềm |
gọi lại | - | URL của máy chủ web của bạn nhận được kết quả nhận dạng hình ảnh xác thực. URL phải được đăng ký lần đầu trong pingback settings trong tài khoản của bạn |
Hết thời gian | 120 | Thời gian chờ thăm dò tính bằng giây cho tất cả các loại hình ảnh xác thực ngoại trừ reCAPTCHA. Xác định thời gian mô-đun cố gắng nhận câu trả lời từ điểm cuối API res.php |
recaptchaTimeout | 600 | Thời gian chờ thăm dò cho reCAPTCHA tính bằng giây. Xác định thời gian mô-đun cố gắng nhận câu trả lời từ điểm cuối API res.php |
pollingInterval | 10 | Khoảng thời gian tính bằng giây giữa các yêu cầu đến điểm cuối API res.php , không nên đặt giá trị dưới 5 giây |
IMPORTANT: khicallback
được xác định cho trường hợpTwoCaptcha
, tất cả các phương thức chỉ trả về ID hình ảnh xác thực và DO KHÔNG thăm dò ý kiến API để lấy kết quả. Kết quả sẽ được gửi đến URL gọi lại. Để nhận câu trả lời theo cách thủ công, hãy sử dụng phương thức getResult
Giải quyết hình ảnh xác nhận
Khi bạn gửi bất kỳ hình ảnh xác thực nào, việc sử dụng hình ảnh xác thực có thể cung cấp các tùy chọn bổ sung để giúp nhân viên của 2Captcha giải quyết vấn đề đó một cách chính xác
Các loại Captcha
Lựa chọn | Giá trị mặc định | Sự mô tả |
---|---|---|
numeric | 0 | Xác định xem hình ảnh xác thực có chứa số hoặc các ký hiệu khác hay không xem thêm thông tin trong tài liệu API |
minLength | 0 | độ dài câu trả lời tối thiểu |
maxLength | 0 | độ dài câu trả lời tối đa |
phrase | 0 | xác định xem câu trả lời có chứa nhiều từ hay không |
Phân biệt chữ hoa chữ thường | 0 | xác định xem câu trả lời có phân biệt chữ hoa chữ thường không |
calc | 0 | xác định captcha cần tính |
lang | - | xác định ngôn ngữ hình ảnh xác thực, xem danh sách các ngôn ngữ được hỗ trợ |
gợi ý | - | một hình ảnh có gợi ý được hiển thị cho công nhân bằng hình ảnh xác thực |
hintText | - | gợi ý hoặc văn bản nhiệm vụ được hiển thị cho nhân viên bằng hình ảnh xác thực |
Ví dụ cơ bản
Ví dụ dưới đây cho thấy một ví dụ cuộc gọi bộ giải cơ bản với xử lý lỗi.
Normal captcha = new Normal();
captcha.setFile("path/to/captcha.jpg");
captcha.setMinLen(4);
captcha.setMaxLen(20);
captcha.setCaseSensitive(true);
captcha.setLang("en");
try {
solver.solve(captcha);
System.out.println("Captcha solved: " + captcha.getCode());
} catch (Exception e) {
System.out.println("Error occurred: " + e.getMessage());
}
- Normal Captca
- TextCaptcha
- reCAPTCHA v2
- reCAPTCHA v3
- FunCaptcha
- GeeTest
- KeyCaptcha
- Capy
- Lưới
- Canvas
- ClickCaptcha
- Quay
Để bỏ qua hình ảnh xác thực thông thường (văn bản bị bóp méo trên hình ảnh), hãy sử dụng phương pháp sau. Phương pháp này cũng có thể được sử dụng để nhận dạng bất kỳ văn bản nào trên hình ảnh.
Normal captcha = new Normal();
captcha.setFile("path/to/captcha.jpg");
captcha.setNumeric(4);
captcha.setMinLen(4);
captcha.setMaxLen(20);
captcha.setPhrase(true);
captcha.setCaseSensitive(true);
captcha.setCalc(false);
captcha.setLang("en");
captcha.setHintImg(new File("path/to/hint.jpg"));
captcha.setHintText("Type red symbols only");
Phương pháp này có thể được sử dụng để bỏ qua hình ảnh xác thực yêu cầu trả lời câu hỏi được cung cấp bằng văn bản rõ ràng.
Text captcha = new Text();
captcha.setText("If tomorrow is Saturday, what day is today?");
captcha.setLang("en");
Sử dụng phương pháp này để giải reCAPTCHA V2 và lấy mã thông báo để vượt qua bảo vệ.
ReCaptcha captcha = new ReCaptcha();
captcha.setSiteKey("6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-");
captcha.setUrl("https://mysite.com/page/with/recaptcha");
captcha.setInvisible(true);
captcha.setAction("verify");
captcha.setProxy("HTTPS", "login:password@IP_address:PORT");
Phương pháp này cung cấp trình giải reCAPTCHA V3 và trả về một mã thông báo.
ReCaptcha captcha = new ReCaptcha();
captcha.setSiteKey("6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-");
captcha.setUrl("https://mysite.com/page/with/recaptcha");
captcha.setVersion("v3");
captcha.setAction("verify");
captcha.setScore(0.3);
captcha.setProxy("HTTPS", "login:password@IP_address:PORT");
Phương pháp giải FunCaptcha (Arkoselabs). Trả về một mã thông báo.
FunCaptcha captcha = new FunCaptcha();
captcha.setSiteKey("69A21A01-CC7B-B9C6-0F9A-E7FA06677FFC");
captcha.setUrl("https://mysite.com/page/with/funcaptcha");
captcha.setSUrl("https://client-api.arkoselabs.com");
captcha.setUserAgent("Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/83.0.4103.61 Safari/537.36");
captcha.setData("anyKey", "anyValue");
captcha.setProxy("HTTPS", "login:password@IP_address:PORT");
Phương pháp giải captcha câu đố GeeTest. Trả về một tập hợp các mã thông báo dưới dạng JSON.
GeeTest captcha = new GeeTest();
captcha.setGt("f2ae6cadcf7886856696502e1d55e00c");
captcha.setApiServer("api-na.geetest.com");
captcha.setChallenge("12345678abc90123d45678ef90123a456b");
captcha.setUrl("https://mysite.com/captcha.html");
captcha.setProxy("HTTPS", "login:password@IP_address:PORT");
Phương pháp dựa trên mã thông báo để giải KeyCaptcha
KeyCaptcha captcha = new KeyCaptcha();
captcha.setUserId(10);
captcha.setSessionId("493e52c37c10c2bcdf4a00cbc9ccd1e8");
captcha.setWebServerSign("9006dc725760858e4c0715b835472f22");
captcha.setWebServerSign2("2ca3abe86d90c6142d5571db98af6714");
captcha.setUrl("https://www.keycaptcha.ru/demo-magnetic/");
captcha.setProxy("HTTPS", "login:password@IP_address:PORT");
Phương pháp dựa trên mã thông báo để vượt qua hình ảnh xác thực câu đố Capy.
Capy captcha = new Capy();
captcha.setSiteKey("PUZZLE_Abc1dEFghIJKLM2no34P56q7rStu8v");
captcha.setUrl("https://www.mysite.com/captcha/");
captcha.setProxy("HTTPS", "login:password@IP_address:PORT");
Phương pháp lưới ban đầu được gọi là phương pháp reCAPTCHA V2 cũ. Phương pháp này có thể được sử dụng để bỏ qua bất kỳ loại hình ảnh xác thực nào mà bạn có thể áp dụng lưới trên hình ảnh và cần nhấp vào các ô lưới cụ thể. Trả về số của hộp.
Phương pháp canvas có thể được sử dụng khi bạn cần vẽ một đường bao quanh một đối tượng trên hình ảnh. Trả về một tập hợp các tọa độ điểm để vẽ một đa giác.
Phương thức ClickCaptcha trả về tọa độ của các điểm trên hình ảnh captcha. Có thể được sử dụng nếu bạn cần nhấp vào các điểm cụ thể trên hình ảnh.
Coordinates captcha = new Coordinates();
captcha.setFile("path/to/captcha.jpg");
captcha.setLang("en");
captcha.setHintImg(new File("path/to/hint.jpg"));
captcha.setHintText("Select all images with an Orange");
Phương pháp này có thể đư ợc sử dụng để giải quyết một hình ảnh xác thực yêu cầu xoay một đối tượng. Chủ yếu được sử dụng để vượt qua FunCaptcha. Trả về góc quay.
Rotate captcha = new Rotate();
captcha.setFile("path/to/captcha.jpg");
captcha.setAngle(40);
captcha.setLang("en");
captcha.setHintImg(new File("path/to/hint.jpg"));
captcha.setHintText("Put the images in the correct way up");
Các phương pháp khác
Các phương pháp hợp lệ bổ sung được sử dụng trong quá trình làm việc của các tập lệnh chính
send / getResult
Các phương pháp này có thể được sử dụng để gửi captcha thủ công và bỏ phiếu trả lời.
String captchaId = solver.send(captcha);
Thread.sleep(20 * 1000);
String code = solver.getResult(captchaId);
balance
Sử dụng phương pháp này để lấy số dư tài khoản của bạn.
double balance = solver.balance();
report
Sử dụng phương pháp này để báo cáo câu trả lời hình ảnh xác thực tốt hoặc xấu.
solver.report(captcha.getId(), true); // captcha solved correctly
solver.report(captcha.getId(), false); // captcha solved incorrectly
Xử lý lỗi
Các biến thể có thể có của lỗi tiêu chuẩn được dịch vụ trả về khi xử lý yêu cầu
Nếu trường hợp lỗi trình giải mã xác thực sẽ ném ra một ngoại lệ. Điều quan trọng là phải xử lý đúng những trường hợp này. Chúng tôi khuyên bạn nên sử dụng try / catch
để xử lý các trường hợp ngoại lệ.
try {
solver.solve(captcha);
} catch (ValidationException e) {
// invalid parameters passed
} catch (NetworkException e) {
// network error occurred
} catch (ApiException e) {
// api respond with error
} catch (TimeoutException e) {
// captcha is not solved so far
}