report – Báo cáo kết quả

report dùng để báo cho chúng tôi biết kết quả của một nhóm tác vụ đúng hay sai, hãy báo cáo cả thành công lẫn thất bại. Với loại nhận dạng hình ảnh, nếu báo cáo “sai”, các tác vụ đủ điều kiện sẽ được hoàn điểm sau khoảng 24 giờ; kết quả báo cáo cũng được dùng để đánh giá và cải thiện khả năng nhận dạng.

POSThttps://api.yescaptcha.com/reportEndpoint quốc tếSao chép

POSThttps://cn.yescaptcha.com/reportEndpoint Trung QuốcSao chép

Tham số yêu cầu

Trường	Kiểu	Bắt buộc	Mô tả
id	array of string	Có	Danh sách ID tác vụ, có thể báo cáo nhiều tác vụ cùng lúc
isSuccess	boolean	Có	true nếu nhận dạng đúng, false nếu nhận dạng sai

Không cần clientKey, bản thân ID tác vụ đã xác định được tác vụ.

{
  "id": ["610ff5e0-68eb-11ef-95a6-22e70a0b794d", "65b88c06-68eb-11ef-8e9a-52540023ccb3"],
  "isSuccess": false
}

Kết quả trả về

{
  "errorId": 0,
  "status": "success"
}

Hãy báo cáo trung thực

Báo cáo vừa dùng để quyết toán hoàn điểm, vừa dùng để đánh giá và cải thiện khả năng nhận dạng, vì vậy hãy báo cáo theo kết quả thực tế:

• Tác vụ nhận dạng đúng thì báo isSuccess: true, sai thì báo false. Những báo cáo chỉ báo thất bại mà không báo thành công, hoặc báo thất bại cho tất cả bất kể đúng sai, sẽ không được dùng làm tham chiếu trong thống kê và quyết toán.
• Tỷ lệ thất bại được tính trên toàn bộ tác vụ bạn đã tạo trong khoảng thời gian đó, không chỉ những tác vụ đã báo cáo. Báo cáo thêm thất bại không giúp được hoàn thêm điểm: nếu tỷ lệ thất bại của bạn cao hơn rõ rệt so với cùng kỳ, chỉ hoàn điểm theo tỷ lệ thất bại của cùng kỳ.
• Khi một lần xác minh dùng nhiều ảnh (ví dụ FunCaptcha phải chọn 5 vòng) và bạn không biết ảnh nào sai, có thể báo cáo cả nhóm tác vụ này là thất bại; khi xác minh thành công, cũng báo cáo cả nhóm này là thành công.

Hoàn điểm sau khi báo cáo thất bại

• Chỉ 5 loại nhận dạng hình ảnh được hoàn điểm: FunCaptchaClassification, HCaptchaClassification, ReCaptchaV2Classification, AwsClassification, bCaptchaClassification.
• Chỉ tính báo cáo gửi trong vòng 1 giờ sau khi tạo tác vụ; mỗi tác vụ chỉ được hoàn điểm một lần.
• Không hoàn điểm ngay lập tức mà được quyết toán chung sau khoảng 24 giờ.
• Khi quyết toán, tỷ lệ thất bại bạn báo cáo được so sánh với những người dùng khác trên cùng câu hỏi trong cùng kỳ; nếu cao hơn rõ rệt so với mặt bằng cùng kỳ, sẽ hoàn điểm theo tỷ lệ thất bại của cùng kỳ.
• Nếu có thắc mắc về kết quả quyết toán, bạn có thể liên hệ bộ phận hỗ trợ để khiếu nại.

Với các loại trả về token (reCAPTCHA, hCaptcha, Turnstile, FunCaptcha, v.v.), token có hợp lệ hay không do trang web đích quyết định, nên báo cáo không được hoàn điểm. Tổng hợp quy tắc tính phí xem tại Tính phí và hoàn điểm.