Captcha gobang là một loại hình ảnh xác thực phổ biến, yêu cầu người dùng hoán đổi vị trí của hai viên bi trong lưới 5×5 sao cho có được 5 viên cùng màu thẳng hàng (ngang, dọc hoặc chéo).
1. Tạo yêu cầu
Request
POST https://api.omocaptcha.com/v2/createTask
Response
Thành công:
Máy chủ trả về errorId = 0 và taskId khi tạo thành công.
Thất bại:
Máy chủ trả về errorId = 1 cùng errorCode là mã lỗi tương ứng.
2. Nhận kết quả yêu cầu
Request
POST https://api.omocaptcha.com/v2/getTaskResult
Response
Thành công:
Máy chủ trả về errorId = 0 và status = ready. Đọc kết quả trong trường solution.
solution.swap_positions là mảng gồm 2 chỉ số ô cần hoán đổi vị trí trong lưới 5×5. Các ô được đánh số từ 0 đến 24, tính từ trái sang phải và từ trên xuống dưới (ô đầu hàng 1 là 0, ô cuối hàng 1 là 4, ô đầu hàng 2 là 5, …, ô cuối hàng 5 là 24). Kéo viên bi ở ô thứ nhất sang ô thứ hai (hoặc ngược lại) để hoàn thành captcha.
Đang xử lý:
Máy chủ trả về errorId = 0 và status = processing, vui lòng chờ 2 giây rồi yêu cầu lại.
Thất bại:
Máy chủ trả về errorId = 1 khi tác vụ thất bại.