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

Postman là một API client dùng để xây dựng request, xem response và tổ chức các collection có thể tái sử dụng. Nó hữu ích khi lập trình viên muốn tách vấn đề về định dạng request khỏi lỗi của SDK hay ứng dụng. Thay vì phải debug đồng thời trình duyệt, ứng dụng và solver client, bạn có thể kiểm tra trao đổi API riêng biệt trước.
Hướng dẫn này dùng CapSolver làm ví dụ API đã được tài liệu hóa. Quy trình bao gồm xác thực tài khoản, gửi tác vụ và kiểm tra kết quả. Nó không khẳng định rằng Postman vận hành một trình duyệt hoặc tự động hoàn thành form được bảo vệ. Hãy dùng trang test của riêng bạn hoặc một quy trình đã được cho phép rõ ràng khi chuyển từ kết quả API sang kiểm thử ứng dụng.
Bạn cần một client Postman, một API key CapSolver, và các input hợp lệ cho loại tác vụ CAPTCHA cụ thể mà bạn muốn test.
Đối với một token task, thường bao gồm URL trang, public site key, cùng các trường bổ sung được yêu cầu trong tài liệu tác vụ hiện tại. Hãy bắt đầu với loại tác vụ được hỗ trợ mà bạn thực sự sử dụng. Đừng thay thế bằng một tên gần giống từ dịch vụ CAPTCHA khác hoặc cho rằng ví dụ reCAPTCHA áp dụng cho mọi nhà cung cấp.
Giữ riêng ba loại thông tin xác thực. Khóa tài khoản CapSolver của bạn xác thực request tới solver API. Site key của website xác định cấu hình CAPTCHA của nó. Secret xác minh dành cho chủ website thuộc về backend của website và không phải là solver account key. Phân biệt điều này giúp tránh lỗi thiết lập thường gặp trước khi bạn gửi request đầu tiên.
Hãy dùng một environment riêng cho lần test này. Postman hỗ trợ biến trong request, giúp tránh phải sửa cùng một giá trị ở nhiều nơi. Lưu trữ secret thực bằng cơ chế cục bộ hoặc vault mà đội bạn phê duyệt. Không bao giờ công khai một collection đã export có chứa account key. Cũng hãy xem lại các thiết lập ủy quyền kế thừa: một bearer token mức collection không liên quan không thể thay thế cho trường clientKey được tài liệu hóa.
Ranh giới xác minh: các mẫu request bên dưới lấy từ tài liệu API chính thức hiện tại. Các placeholder cần được thay bằng thông tin xác thực và input trang đã được cho phép của riêng bạn. Một request getBalance thực thi bằng Postman Newman với placeholder key cố ý không hợp lệ đã đến đúng endpoint chính thức và trả về một lỗi JSON API. Điều đó chỉ kiểm tra nhánh xác thực âm tính; xác thực thành công, tạo tác vụ và giải CAPTCHA yêu cầu tài khoản của riêng bạn và không được thử trong lần kiểm tra này.
Request getBalance là nơi đơn giản nhất để xác nhận xác thực tài khoản mà không cần tạo tác vụ giải có tính phí.
Tạo một request POST tới https://api.capsolver.com/getBalance. Chọn body JSON raw và xác nhận request dùng Content-Type: application/json. Dùng cấu trúc request getBalance chính thức, thay placeholder cục bộ:
{
"clientKey": "YOUR_API_KEY"
}
Gửi request và kiểm tra response body. Chỉ có HTTP response là chưa đủ: hãy kiểm tra các trường lỗi của API. Một response xác thực thành công sẽ bao gồm thông tin tài khoản như trong tài liệu. Một lỗi xác thực cho biết bạn cần sửa key hoặc quyền truy cập tài khoản trước khi test một CAPTCHA task.
Nếu Postman nhận HTML, lỗi proxy hoặc redirect bất thường, hãy kiểm tra URL và thành phần trả về response đó trước. Đừng cố giải CAPTCHA chỉ để chẩn đoán một endpoint API sai. Giữ TLS verification được bật; lỗi chứng chỉ cần được điều tra thay vì che giấu trong thiết lập client.
Postman cũng có thể import request cURL. Tài liệu import của Postman giải thích cách này. Nếu bạn import một ví dụ chính thức, hãy kiểm tra lại method, URL, header và body sau đó. Import một request không chứng minh thông tin xác thực hay input tác vụ của nó là hợp lệ.
CreateTask gửi một tác vụ giải CAPTCHA; loại tác vụ quyết định những trường nào thuộc về body.
Đối với một tác vụ reCAPTCHA v2 proxyless tiêu chuẩn, tài liệu tham chiếu reCAPTCHA v2 chính thức định nghĩa cấu trúc sau. Đây là template request minh họa: hãy thay tất cả placeholder bằng giá trị thật cho trang test đã được cho phép của bạn trước khi gửi tới https://api.capsolver.com/createTask.
{
"clientKey": "YOUR_API_KEY",
"task": {
"type": "ReCaptchaV2TaskProxyLess",
"websiteURL": "YOUR_AUTHORIZED_PAGE_URL",
"websiteKey": "YOUR_WEBSITE_SITE_KEY"
}
}
Chữ hoa chữ thường trong kiểu tác vụ rất quan trọng. Sao chép tên trường từ tài liệu tham chiếu chính thức thay vì đoán từ tên sản phẩm. Đừng thêm các tham số không được hỗ trợ để bù đắp cho một lỗi mà bạn chưa xác định nguyên nhân.
Lưu request này tách biệt khỏi request balance. Đặt cho nó một tên collection mô tả, như loại tác vụ và môi trường test, để bạn không vô tình chạy task sản xuất khi đang kiểm tra trang phát triển. Với một lần test thủ công, hãy nhấn Send một lần và kiểm tra kết quả trước khi làm bất cứ điều gì khác.
Nếu response báo lỗi, hãy sửa lỗi đó trước khi tiếp tục. Nếu một tác vụ bất đồng bộ đã được tạo, hãy giữ lại taskId trả về. Request sau phải dùng đúng định danh đó. Bấm Send lặp lại trên createTask sẽ tạo các lần thử mới; đó không phải là cách hỏi về một tác vụ đã tồn tại.
Nhận mã thưởng CapSolver của bạn
Tăng ngân sách tự động hóa ngay lập tức!
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.
Đổi mã ngay trong Bảng điều khiển CapSolver
Với một tác vụ bất đồng bộ, getTaskResult kiểm tra tác vụ bạn đã gửi.
Tạo một request POST riêng tới https://api.capsolver.com/getTaskResult. Request task-result chính thức dùng cùng account key và định danh tác vụ trả về:
{
"clientKey": "YOUR_API_KEY",
"taskId": "TASK_ID_RETURNED_BY_CREATE_TASK"
}
Kiểm tra errorId trước khi diễn giải status. Trạng thái processing nghĩa là chưa có solution để dùng. Trạng thái ready nghĩa là bạn có thể kiểm tra đối tượng solution theo tài liệu. Đối với tác vụ reCAPTCHA v2 ở trên, token được trả về trong solution.gRecaptchaResponse. Các loại tác vụ khác có thể trả về các trường khác, nên hãy chọn parser theo đúng hợp đồng tác vụ.
Bắt đầu bằng các request thủ công trong khi bạn đang tìm hiểu quá trình trao đổi. Chờ theo hướng dẫn polling hiện tại trong tài liệu trước khi kiểm tra lại, và dừng tại thời hạn task đã định trước. Đừng đặt createTask bên trong một lần chạy collection lặp lại chỉ để bắt chước polling. Nếu ứng dụng của bạn sau này tự động hóa polling, hãy dùng cùng taskId cho lần đó và xử lý rõ ràng các lỗi kết thúc.
Kết quả một tác vụ là dữ liệu vận hành nhạy cảm. Hãy che token khi chia sẻ ảnh chụp màn hình với đồng nghiệp. TaskId và mã lỗi có thể là đủ để giải thích vấn đề của request; một bản dump toàn bộ response thường không cần thiết.
ImageToTextTask trả về text nhận dạng ngay trong response của createTask thay vì yêu cầu getTaskResult.
Dùng tài liệu tham chiếu ImageToTextTask chính thức khi test một ảnh CAPTCHA dạng chữ. Trường body chứa dữ liệu Base64 của ảnh. Hãy tách riêng ảnh đó khỏi PDF báo cáo, tài liệu hóa đơn hoặc ảnh chụp toàn bộ màn hình trình duyệt: endpoint này dành cho tác vụ nhận dạng ảnh đã được tài liệu hóa, không phải trích xuất tài liệu tùy ý.
Kiểm tra response để tìm lỗi API rồi đọc solution.text khi call thành công. Giữ kết quả dưới dạng chuỗi. Việc chuyển một giá trị đã nhận dạng như 0072 sang dạng số sẽ làm thay đổi nó trước khi ứng dụng có cơ hội xác thực câu trả lời.
Chính hành vi phản hồi trực tiếp này là lý do tại sao một vòng lặp collection “phổ quát” là điểm khởi đầu tệ. Hãy xây một nhóm request nhỏ cho tác vụ bạn cần và làm theo đúng hợp đồng trả về của nhóm đó. Hướng dẫn API image-to-text hiện có giải thích ranh giới input và output chi tiết hơn.
Việc xử lý sự cố sẽ nhanh hơn khi bạn phân biệt trao đổi HTTP, kết quả API và kết quả website.
Ở tầng HTTP, hãy kiểm tra đích thực tế, loại response và việc client có nhận được response hay không. Ở tầng API, hãy kiểm tra errorId và mã lỗi theo tài liệu. Ở tầng website, hãy kiểm tra xem ứng dụng có chấp nhận một solution đúng, còn hiệu lực và được gắn với đúng ngữ cảnh hay không. Danh sách mã lỗi chính thức là nguồn giải thích ý nghĩa lỗi API.
Nếu request balance thất bại, tham số tác vụ chưa phải là điều đầu tiên cần thay đổi. Nếu xác thực balance thành công nhưng createTask thất bại, hãy kiểm tra loại tác vụ đã chọn và các trường bắt buộc của nó. Nếu một task ở trạng thái ready nhưng ứng dụng từ chối kết quả, việc lặp lại cùng request Postman có thể chỉ tạo thêm các task mới. Thay vào đó hãy kiểm tra ngữ cảnh trang và luồng xác minh của website.
Đừng mô tả một token response thành công như một bài test end-to-end trên trình duyệt. Postman chưa tự động cung cấp token cho ứng dụng của bạn, chưa giữ trạng thái trình duyệt, chưa gửi form hoặc xác minh kết quả nghiệp vụ. Với tích hợp reCAPTCHA của riêng bạn, tài liệu xác minh phía server của Google giải thích trách nhiệm riêng của website.
Một collection hữu ích lưu được cấu trúc request và các kiểm tra response mong đợi nhưng không đưa secret vào các artifact chia sẻ.
Hãy lưu riêng các request cho balance, tạo task và lấy kết quả task. Giải thích giá trị nào do người dùng cung cấp và giá trị nào đến từ response trước đó. Xóa các token ví dụ và account key trước khi export collection. Kiểm tra file JSON đã export thay vì cho rằng một trường bị che trong giao diện là an toàn để chia sẻ.
Collection runner của Postman có thể giúp lặp lại một chuỗi request được kiểm soát. Giữ phạm vi rõ ràng: kiểm tra định dạng request, kiểm tra xác thực và một lần solve có tính phí là những bài test khác nhau. Dùng một ngân sách test nhỏ đã được phê duyệt cho bài test cuối, với input task đã biết và điều kiện dừng rõ ràng.
Dùng Postman để làm rõ trao đổi API trước khi thêm độ phức tạp của ứng dụng. Khi các trường request và xử lý kết quả đã đúng, hãy chuyển cùng hợp đồng đã được tài liệu hóa đó vào ứng dụng của bạn và xác minh kết quả thật. CapSolver cung cấp bước giải CAPTCHA được hỗ trợ; quy trình của bạn vẫn chịu trách nhiệm dùng kết quả đúng cách.
Hỏi: Postman có thể tự giải CAPTCHA không?
Postman gửi API request. Dịch vụ giải CAPTCHA thực hiện tác vụ giải được hỗ trợ, còn ứng dụng của bạn xử lý kết quả trả về.
Hỏi: Tôi nên đặt CapSolver API key ở đâu?
Đặt nó vào trường clientKey của JSON request theo tài liệu. Giữ giá trị thật ở chế độ riêng tư và đừng nhầm nó với public site key của website.
Hỏi: Có phải mọi task đều cần getTaskResult không?
Không. Các tác vụ bất đồng bộ dùng endpoint task-result, trong khi ImageToTextTask trả về kết quả nhận dạng trực tiếp. Hãy làm theo tài liệu hiện tại cho loại tác vụ bạn chọn.
Hỏi: Tại sao tôi nhận được token nhưng website vẫn báo lỗi?
Website có bước chấp nhận riêng. Một token đúng, còn hiệu lực và gắn đúng ngữ cảnh phải được dùng trong luồng ứng dụng phù hợp; nhận nó trong Postman không hoàn thành luồng đó.
Hỏi: Tôi có nên chạy createTask lặp lại trong khi chờ không?
Không. Hãy kiểm tra tác vụ bất đồng bộ hiện tại bằng getTaskResult và taskId đã trả về. Việc tạo task lặp lại không phải là polling và có thể tạo thêm công việc và chi phí không cần thiết.

Anh Tuan
Data Science Expert
Turning task outcomes into actionable insights.
GIỚI THIỆU TÁC GIẢ
So sánh các trình giải CAPTCHA Python theo thiết kế SDK, hỗ trợ async, dữ liệu đầu vào của tác vụ và trách nhiệm của trình duyệt. Chọn một API có bài kiểm tra chấp nhận mang tính thực tiễn.

Tìm hiểu khi nào CAPTCHA phân biệt chữ hoa chữ thường, cách tránh lỗi viết hoa viết thường và ý nghĩa của các giới hạn nhận dạng hình ảnh đối với việc tích hợp trình giải CAPTCHA của bạn.
