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

> POST /report báo cho YesCaptcha biết kết quả của tác vụ đúng hay sai; hãy báo cáo trung thực cả thành công lẫn thất bại. Với loại nhận dạng hình ảnh, báo cáo thất bại trong vòng 1 giờ sau khi tạo tác vụ sẽ được quyết toán hoàn điểm sau khoảng 24 giờ.

Source: https://docs.yescaptcha.com/vi/api/report/ · Last verified: 2026-10-15

> This page was machine-translated from the Chinese version. If anything differs, the Chinese version prevails: https://docs.yescaptcha.com/zh/api/report/

`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.

- POST `https://api.yescaptcha.com/report` (Endpoint quốc tế)
- POST `https://cn.yescaptcha.com/report` (Endpoint Trung Quốc)

## 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ụ.

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

## Kết quả trả về

```json
{
  "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ợ](https://docs.yescaptcha.com/vi/help/contact.md) để 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](https://docs.yescaptcha.com/vi/getting-started/billing.md).