# report 결과 신고

> POST /report로 작업의 인식 결과가 맞았는지 신고해요. 성공과 실패 모두 사실대로 신고해 주세요. 이미지 인식 유형은 작업 생성 후 1시간 이내에 실패를 신고하면 약 24시간 뒤에 포인트 환불이 정산돼요.

Source: https://docs.yescaptcha.com/ko/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`는 작업 묶음의 인식 결과가 맞았는지 알려 주는 API예요. **성공과 실패 모두 신고해 주세요.** 이미지 인식 유형에서 “오류”로 신고하면 조건에 맞는 경우 약 24시간 뒤에 포인트가 환불돼요. 신고한 결과는 인식 품질을 평가하고 개선하는 데도 쓰여요.

- POST `https://api.yescaptcha.com/report` (글로벌 엔드포인트)
- POST `https://cn.yescaptcha.com/report` (중국 엔드포인트)

## 요청 파라미터

| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `id` | array of string | 예 | 작업 ID 목록이에요. 한 번에 여러 개를 신고할 수 있어요 |
| `isSuccess` | boolean | 예 | `true`는 인식 성공, `false`는 인식 오류예요 |

`clientKey`는 필요 없어요. 작업 ID만으로 작업을 찾을 수 있어요.

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

## 응답

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

## 사실대로 신고해 주세요

신고는 포인트 환불 정산에도, 인식 품질을 평가하고 개선하는 데도 쓰여요. 실제 결과대로 신고해 주세요.

-   인식이 맞은 작업은 `isSuccess: true`로, 틀린 작업은 `false`로 신고해요. 실패만 신고하거나 맞고 틀림과 상관없이 모두 실패로 신고하면 통계와 정산에서 참고하지 않아요.
-   실패율은 이 기간에 만든 전체 작업을 기준으로 계산해요. 신고한 작업만 계산하지 않아요. 실패를 더 많이 신고해도 환불이 늘지 않아요. 실패율이 같은 기간의 수준보다 뚜렷하게 높으면 같은 기간의 실패율만큼만 환불해요.
-   한 번의 인증에 이미지를 여러 장 쓰고(예: FunCaptcha는 5라운드를 풀어야 해요) 어느 것이 틀렸는지 모를 때는 해당 작업 묶음을 모두 실패로 신고하면 돼요. 인증을 통과했을 때도 같은 묶음을 모두 성공으로 신고해 주세요.

## 신고 후 포인트 환불

-   포인트 환불이 되는 유형은 이미지 인식 5가지뿐이에요: `FunCaptchaClassification`, `HCaptchaClassification`, `ReCaptchaV2Classification`, `AwsClassification`, `bCaptchaClassification`.
-   작업을 만든 뒤 **1시간 이내**에 한 신고만 인정해요. 같은 작업은 한 번만 환불해요.
-   바로 환불되지 않고 **약 24시간 뒤**에 한꺼번에 정산해요.
-   정산할 때 같은 기간에 같은 질문을 푼 다른 사용자와 비교해요. 신고한 실패율이 같은 기간의 수준보다 뚜렷하게 높으면 같은 기간의 실패율만큼 환불해요.
-   정산에 이의가 있으면 [고객 지원에 문의](https://docs.yescaptcha.com/ko/help/contact.md)해 이의를 제기할 수 있어요.

토큰을 반환하는 작업 유형(reCAPTCHA, hCaptcha, Turnstile, FunCaptcha 등)은 토큰이 통과하는지를 대상 사이트가 판단하므로 신고해도 포인트가 환불되지 않아요. 과금 규칙은 [과금과 포인트 환불](https://docs.yescaptcha.com/ko/getting-started/billing.md)에서 한눈에 볼 수 있어요.