콘텐츠로 이동
서비스 상태대시보드

API 레퍼런스

report 결과 신고

이 페이지는 중국어 버전을 기계 번역한 것이라 부정확한 내용이 있을 수 있어요. 중국어 버전을 기준으로 해 주세요.

report는 작업 묶음의 인식 결과가 맞았는지 알려 주는 API예요. 성공과 실패 모두 신고해 주세요. 이미지 인식 유형에서 “오류”로 신고하면 조건에 맞는 경우 약 24시간 뒤에 포인트가 환불돼요. 신고한 결과는 인식 품질을 평가하고 개선하는 데도 쓰여요.

POSThttps://api.yescaptcha.com/report글로벌 엔드포인트
POSThttps://cn.yescaptcha.com/report중국 엔드포인트
필드 타입 필수 설명
id array of string 예 작업 ID 목록이에요. 한 번에 여러 개를 신고할 수 있어요
isSuccess boolean 예 true는 인식 성공, false는 인식 오류예요

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

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

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

  • 인식이 맞은 작업은 isSuccess: true로, 틀린 작업은 false로 신고해요. 실패만 신고하거나 맞고 틀림과 상관없이 모두 실패로 신고하면 통계와 정산에서 참고하지 않아요.
  • 실패율은 이 기간에 만든 전체 작업을 기준으로 계산해요. 신고한 작업만 계산하지 않아요. 실패를 더 많이 신고해도 환불이 늘지 않아요. 실패율이 같은 기간의 수준보다 뚜렷하게 높으면 같은 기간의 실패율만큼만 환불해요.
  • 한 번의 인증에 이미지를 여러 장 쓰고(예: FunCaptcha는 5라운드를 풀어야 해요) 어느 것이 틀렸는지 모를 때는 해당 작업 묶음을 모두 실패로 신고하면 돼요. 인증을 통과했을 때도 같은 묶음을 모두 성공으로 신고해 주세요.
  • 포인트 환불이 되는 유형은 이미지 인식 5가지뿐이에요: FunCaptchaClassification, HCaptchaClassification, ReCaptchaV2Classification, AwsClassification, bCaptchaClassification.
  • 작업을 만든 뒤 1시간 이내에 한 신고만 인정해요. 같은 작업은 한 번만 환불해요.
  • 바로 환불되지 않고 약 24시간 뒤에 한꺼번에 정산해요.
  • 정산할 때 같은 기간에 같은 질문을 푼 다른 사용자와 비교해요. 신고한 실패율이 같은 기간의 수준보다 뚜렷하게 높으면 같은 기간의 실패율만큼 환불해요.
  • 정산에 이의가 있으면 고객 지원에 문의해 이의를 제기할 수 있어요.

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