
Anh Tuan
Data Science Expert
Đã xuất bản Nov 20, 2026
Đã cập nhật Nov 20, 2026 · đọc tối thiểu

Dữ liệu đầu vào API của trình giải CAPTCHA là thông tin xác thực, mã định danh tác vụ và dữ liệu thử thách mà dịch vụ giải dùng để xử lý một yêu cầu CAPTCHA. Trong CapSolver, yêu cầu createTask tách thông tin xác thực tài khoản của bạn, clientKey, khỏi đối tượng task mô tả thử thách.
Sự phân tách này quan trọng khi kết nối trình giải với ứng dụng sẵn có. Trình duyệt có thể đang xử lý một yêu cầu dịch vụ với hàng chục trường, nhưng các trường đó không tự động thuộc về tác vụ CAPTCHA. Hãy bắt đầu từ loại thử thách và yêu cầu được ghi trong tài liệu của nó. Quyết định dữ liệu cần gửi dựa trên “hợp đồng” đó, thay vì tuần tự hóa mọi thứ mà trình duyệt hay agent hiện đang biết.
Hướng dẫn này giải thích các nhóm dữ liệu đầu vào cho tác vụ image-to-text, reCAPTCHA v2 và Cloudflare Turnstile độc lập. Đây là tài liệu tham chiếu về lựa chọn trường dữ liệu, không phải tuyên bố rằng một cấu trúc yêu cầu hỗ trợ mọi thử thách hay rằng trình giải kiểm soát website đích.
Dữ liệu bắt buộc phụ thuộc vào việc trình giải nhận hình ảnh hay thông tin về thử thách dạng widget. Bảng dưới đây so sánh một số loại tác vụ CapSolver; không phải toàn bộ danh sách các tác vụ được hỗ trợ.
| Thử thách | Loại tác vụ | Dữ liệu đầu vào cốt lõi | Ngữ cảnh bổ sung |
|---|---|---|---|
| Văn bản trong hình ảnh | ImageToTextTask |
Dữ liệu hình ảnh trong body |
Các tùy chọn như mô-đun nhận dạng hoặc URL nguồn trang, nếu có ghi trong tài liệu |
| reCAPTCHA v2 tiêu chuẩn | ReCaptchaV2TaskProxyLess |
websiteURL và websiteKey |
Các trường được ghi trong tài liệu phù hợp với cấu hình thử thách thực tế |
| Turnstile độc lập | AntiTurnstileTaskProxyLess |
websiteURL và websiteKey |
metadata.action và metadata.cdata khi áp dụng |
Mỗi tác vụ cũng cần trường type, và yêu cầu bao ngoài cần thông tin xác thực cho trình giải. Đừng coi các trường tùy chọn là “danh sách mua sắm”: thêm mọi tham số có thể không đảm bảo rằng yêu cầu mô tả đúng thử thách hiện tại.
ImageToTextTask nhận hình ảnh ở dạng Base64 trong body. Định dạng được tài liệu mô tả loại trừ tiền tố data:image/...;base64, và xuống dòng. Một tên file cục bộ không phải là nội dung hình ảnh.
Với một form dịch vụ được phép có CAPTCHA chữ nhỏ, hãy chuẩn bị chính hình CAPTCHA đó. Đừng thay thế bằng ảnh chụp toàn bộ trang có cả nội dung hỏi đáp, thông tin liên hệ hay lịch sử đơn hàng của khách. Phần nội dung xung quanh đó không liên quan đến việc nhận dạng ký tự.
Việc chuẩn bị hình ảnh vẫn phải giữ lại thông tin cần để đọc thử thách. Một phần cắt (crop) làm mất ký tự là đầu vào không đầy đủ. Ảnh chụp màn hình của một lần tải ảnh lỗi cũng là đầu vào sai, kể cả khi chuỗi Base64 là hợp lệ. Đây là vấn đề chọn nội dung, khác với vấn đề định dạng yêu cầu.
Một tác vụ reCAPTCHA v2 dùng websiteURL cho trang chứa thử thách và websiteKey cho site key của widget. Địa chỉ trang phải mô tả đúng trang liên quan; một URL trang chủ nhớ được không phải lúc nào cũng thay thế được.
Tùy cấu hình, tài liệu mô tả các trường bổ sung như pageAction, recaptchaDataSValue hoặc payload Enterprise. Hãy dùng biến thể tác vụ phù hợp và schema hiện tại của nó. Đừng sao chép tham số Enterprise vào tác vụ chuẩn chỉ vì thấy chúng trong một ví dụ yêu cầu.
Cấu hình widget reCAPTCHA của Google hiển thị site key trong các thiết lập phía trang như data-sitekey. Mã nhận diện widget công khai này không nên bị nhầm với thông tin xác thực tài khoản trình giải riêng tư của bạn.
Tác vụ Turnstile độc lập yêu cầu URL trang và site key. Schema của nó cũng hỗ trợ action và cdata bên trong metadata. Cung cấp các giá trị này khi chúng thực sự thuộc về thử thách đang xử lý; đừng tự bịa nhãn chỉ để làm yêu cầu trông “đầy đủ” hơn.
Một trang Cloudflare nhắc đến kiểm tra bảo mật không đủ chứng minh rằng chính tác vụ này được áp dụng. Turnstile độc lập và thử thách Cloudflare toàn trang có tài liệu và yêu cầu riêng. Xác định luồng nào mà ứng dụng của bạn gặp phải trước khi chọn các trường dữ liệu đầu vào.
Các key này nhận diện các bên khác nhau và phải nằm ở đúng phần tương ứng của quy trình. Trộn lẫn chúng có thể biến một yêu cầu vốn đúng thành lỗi xác thực hoặc cấu hình.
| Giá trị | Mục đích | Vị trí thích hợp |
|---|---|---|
| Solver API key | Ủy quyền cho ứng dụng của bạn sử dụng dịch vụ giải | Phần xác thực của yêu cầu gửi tới trình giải, theo tài liệu dịch vụ đó |
| CAPTCHA site key | Nhận diện widget đang dùng trên trang | Các tham số widget trong tác vụ tương ứng |
| Verification secret của chủ website | Cho phép site xác minh phản hồi CAPTCHA với nhà cung cấp thử thách | Quá trình xác minh phía server của website |
Mục từ “API key” giải thích lý do cần bảo vệ thông tin xác thực API. Hãy giữ thông tin xác thực trình giải trong cấu hình phía server được kiểm soát của ứng dụng thay vì đặt vào form công khai hay script gửi xuống trình duyệt. Tài liệu hướng dẫn quản lý bí mật của OWASP cung cấp các nguyên tắc chung để kiểm soát truy cập các thông tin như vậy.
Verification secret của chủ website là khái niệm tách biệt. Ví dụ, tài liệu xác minh Turnstile của Cloudflare mô tả việc một server gửi secret của nó và token phản hồi tới Siteverify. Secret đó không phải là websiteKey mà một tác vụ trình giải độc lập yêu cầu.
Nếu ứng dụng của bạn là client được ủy quyền của website người khác, đừng tự mặc định rằng bạn cần truy cập verification secret riêng tư của site. Hãy dùng các dữ liệu đầu vào được tài liệu của tác vụ trình giải yêu cầu và để đích đến tự thực hiện xác minh.
Nhận Mã Thưởng CapSolver Của Bạn
Tăng ngay ngân sách tự động hóa!
Dùng mã thưởng CAP26 khi nạp tiền vào tài khoản CapSolver để nhận thêm 5% bonus cho mỗi lần nạp — không giới hạn.
Hãy đổi mã ngay trong Bảng điều khiển CapSolver
Các schema tác vụ đã nêu không yêu cầu toàn bộ form nghiệp vụ, HTML trang hay lịch sử hội thoại của agent. Hãy xây dựng yêu cầu gửi đi dựa trên các trường được tài liệu mô tả, thay vì chuyển tiếp toàn bộ trạng thái ứng dụng.
Xem ví dụ một form gửi yêu cầu kinh doanh được ủy quyền. Ứng dụng của bạn có thể lưu mã sản phẩm, số lượng yêu cầu, địa chỉ liên hệ và nội dung tin nhắn. Nếu trang hiển thị CAPTCHA chữ trong hình, yêu cầu nhận dạng có thể được chuẩn bị từ chính ảnh CAPTCHA đó. Nội dung yêu cầu vẫn nằm trong quy trình xử lý form riêng của ứng dụng. Đây là ví dụ về việc tách biệt trách nhiệm, không phải một tích hợp đã được kiểm thử với website cụ thể.
Một tác vụ dạng widget làm thay đổi nội dung phần thử thách: URL trang, site key và ngữ cảnh áp dụng thay thế hình ảnh. Yêu cầu kinh doanh vẫn không trở thành dữ liệu đầu vào của trình giải chỉ vì nó xuất hiện trên cùng màn hình.
Hãy áp dụng cùng mức độ xem xét cho cả các trường tưởng như vô hại. Một URL trang có thể chứa tham chiếu tài khoản hay thông tin khác trong query string. Hãy xem xét liệu chia sẻ URL bắt buộc đó có phù hợp với quy trình được ủy quyền hay không. Đừng lặng lẽ xóa bỏ ngữ cảnh thử thách bắt buộc hoặc thay thế bằng trang khác để che giấu sự không khớp. Nếu dữ liệu bắt buộc không thể chia sẻ, hãy giải quyết ràng buộc đó trước khi thực hiện cuộc gọi.
Với các nhóm tác vụ được hỗ trợ khác ngoài bài viết này, hãy xem tài liệu riêng của chúng. Một số tác vụ cần thêm thông tin môi trường hoặc phiên làm việc. Việc thiếu một trường trong bảng so sánh này không có nghĩa là trường đó không cần thiết ở mọi nơi.
Dữ liệu đầu vào chưa đầy đủ khi nó không mô tả đúng thử thách được yêu cầu bởi tác vụ đã chọn, kể cả khi yêu cầu là JSON hợp lệ. Hãy xem lại lựa chọn tác vụ và các giá trị thực tế trước khi thêm dữ liệu không liên quan hoặc gửi lại cùng yêu cầu.
| Triệu chứng trong yêu cầu | Cần kiểm tra gì |
|---|---|
| Trường Base64 chứa đường dẫn file | Xem liệu đã gửi byte hình ảnh hay chỉ tham chiếu tới file cục bộ |
| Hình ảnh hiển thị toàn bộ form | Xem CAPTCHA cần nhận dạng có đọc được không và liệu thông tin nghiệp vụ không liên quan có bị đưa vào không cần thiết |
| Tác vụ widget có URL nhưng không có site key | Mã nhận diện widget mà tác vụ đó yêu cầu |
| Tham số đến từ trang hay môi trường khác | Xem URL, site key và ngữ cảnh liên quan có mô tả cùng một thử thách hay không |
| Tác vụ tiêu chuẩn lại chứa các trường Enterprise sao chép lại | Xem biến thể tác vụ và tên tham số có khớp với tài liệu hiện tại hay không |
| Trường tùy chọn chứa giá trị đoán mò | Xem thử thách thực tế có cung cấp ngữ cảnh đó hay không |
Với các vấn đề cụ thể liên quan tới mã định danh reCAPTCHA và token trả về, hướng dẫn xử lý lỗi site key hoặc token không hợp lệ bao quát nhiệm vụ chẩn đoán hẹp hơn đó.
Một bước rà soát yêu cầu hữu ích có thể ghi lại loại tác vụ, các trường bắt buộc hiện có và tài liệu nào biện minh cho từng trường tùy chọn. Bạn không cần dán thông tin xác thực, hình ảnh thô hay token đầy đủ vào phiếu rà soát để giải thích các quyết định đó. Cách này giúp việc rà soát tập trung vào “hợp đồng” của yêu cầu thay vì tích tụ thêm bản sao payload.
Schema đầu vào cho biết API chấp nhận những gì; nó không thể hiện chính sách lưu trữ, cam kết hợp đồng hay quyết định cuối cùng của đích đến. Hãy tách biệt các câu hỏi đó khi đánh giá tích hợp trình giải.
Trước khi dùng trong môi trường thật, hãy đánh giá dữ liệu thực tế mà ứng dụng sẽ gửi và tham khảo các chính sách hoặc thỏa thuận liên quan của nhà cung cấp để nắm yêu cầu xử lý. Đừng suy luận lịch xóa dữ liệu, cam kết vị trí lưu trữ hay hạn chế dùng cho huấn luyện chỉ từ một ví dụ tác vụ ngắn. Không có đảm bảo nào trong số đó xuất phát đơn thuần từ sự hiện diện của websiteURL hay body.
Tương tự, câu trả lời hoặc token trả về chỉ là một thành phần của quy trình. Ứng dụng của bạn phải kiểm tra xem trang hay dịch vụ dự kiến có chấp nhận hành động tiếp theo đã được ủy quyền hay không. Một yêu cầu tới trình giải thành công không thể khẳng định rằng yêu cầu kinh doanh đã được gửi, tài liệu đã được lấy hay đích đến đã cấp quyền cho hoạt động tiếp theo.
Một yêu cầu CAPTCHA rõ ràng bắt đầu từ loại thử thách được hỗ trợ, sau đó bao gồm các đầu vào bắt buộc và ngữ cảnh áp dụng của nó. Hãy giữ tách biệt thông tin xác thực trình giải, mã nhận diện widget và dữ liệu nghiệp vụ trong suốt quá trình này.
Cách tiếp cận này giúp việc rà soát yêu cầu dễ dàng hơn: mỗi trường gửi đi đều có mục đích được ghi trong tài liệu, và ngữ cảnh thử thách thiếu có thể được điều tra mà không cần chuyển tiếp toàn bộ trạng thái trình duyệt. Hãy dùng tài liệu tác vụ hiện tại mỗi khi loại thử thách hoặc cấu hình trang thay đổi.
Hãy dùng CapSolver cho bước CAPTCHA được hỗ trợ trong quy trình tự động hóa đã được ủy quyền của bạn. Bắt đầu từ schema tác vụ phù hợp, chỉ chuẩn bị các dữ liệu đầu vào bắt buộc và áp dụng, và giữ bước kiểm tra kết quả tại đích trong chính ứng dụng của bạn.
Hỏi: Mọi tác vụ trình giải CAPTCHA đều cần hình ảnh phải không?
Không. Nhận dạng image-to-text dùng dữ liệu hình ảnh, trong khi reCAPTCHA v2 và Turnstile độc lập được mô tả ở đây dùng các tham số trang và widget. Hãy chọn tác vụ trước khi chuẩn bị payload.
Hỏi: Tôi có thể dùng solver API key làm websiteKey không?
Không. Solver API key ủy quyền yêu cầu của bạn tới dịch vụ; websiteKey nhận diện widget CAPTCHA. Hai giá trị này không thể thay thế cho nhau.
Hỏi: Tôi có nên gửi các trường tùy chọn nếu không biết giá trị của chúng không?
Không. Chỉ dùng trường tùy chọn khi thử thách hiện tại và tài liệu tác vụ yêu cầu. Việc đoán action hay sao chép ngữ cảnh không liên quan không thể bù đắp dữ liệu thiếu.
Hỏi: API có cần thông tin khách hàng từ form không?
Các schema tác vụ được chọn trong hướng dẫn này không yêu cầu thông tin liên hệ khách hàng, nội dung yêu cầu hay hồ sơ đơn hàng. Hãy giữ dữ liệu ứng dụng đó tách biệt khỏi dữ liệu đầu vào của thử thách và rà soát mọi thông tin nhạy cảm bị nhúng trong trường bắt buộc.
Hỏi: Gửi ít trường hơn có đảm bảo kết quả thành công không?
Không. Mục tiêu là một yêu cầu đúng, cụ thể cho tác vụ, chứ không phải yêu cầu nhỏ nhất bằng mọi giá. Bỏ qua dữ liệu bắt buộc hoặc ngữ cảnh thử thách áp dụng có thể khiến yêu cầu không đầy đủ, và đích đến vẫn là bên quyết định có chấp nhận hành động tiếp theo hay không.

Anh Tuan
Data Science Expert
Turning task outcomes into actionable insights.
GIỚI THIỆU TÁC GIẢ