report — reportar resultados

report sirve para decirnos si el resultado de un grupo de tareas fue correcto o no. Reporta tanto los éxitos como los fallos. Cuando reportas como incorrecto el resultado de un tipo de reconocimiento de imágenes, los casos que cumplen las condiciones reciben un reembolso de puntos tras unas 24 horas; los reportes también se usan para evaluar y mejorar el reconocimiento.

POSThttps://api.yescaptcha.com/reportEndpoint globalCopiar

POSThttps://cn.yescaptcha.com/reportEndpoint ChinaCopiar

Parámetros de la solicitud

Campo	Tipo	Obligatorio	Descripción
id	array of string	Sí	Lista de IDs de tarea; puedes reportar varias a la vez
isSuccess	boolean	Sí	true si el resultado fue correcto, false si fue incorrecto

No se necesita clientKey: el ID de tarea ya identifica la tarea.

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

Respuesta

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

Reporta con honestidad

Los reportes sirven tanto para liquidar el reembolso como para evaluar y mejorar el reconocimiento, así que repórtalos según el resultado real:

• Reporta isSuccess: true para las tareas con resultado correcto y false para las incorrectas. Los reportes que solo marcan fallos, o que marcan todo como fallo sin importar el resultado, no se toman como referencia en las estadísticas ni en la liquidación.
• La tasa de fallos se calcula sobre todas las tareas que creaste en ese periodo, no solo sobre las que reportaste. Reportar más fallos no te da más reembolsos: si tu tasa de fallos es claramente superior a la del mismo periodo, el reembolso se calcula solo con la tasa de fallos de ese periodo.
• Cuando una verificación usa varias imágenes (por ejemplo, FunCaptcha pide 5 rondas) y no sabes cuál falló, puedes reportar todo el grupo de tareas como fallido; cuando la verificación se supera, reporta igualmente todo el grupo como exitoso.

Reembolso tras reportar un fallo

• Solo 5 tipos de reconocimiento de imágenes admiten reembolso: FunCaptchaClassification, HCaptchaClassification, ReCaptchaV2Classification, AwsClassification y bCaptchaClassification.
• Solo cuentan los reportes hechos dentro de 1 hora desde la creación de la tarea; cada tarea se reembolsa una sola vez.
• El reembolso no es inmediato: se liquida en conjunto unas 24 horas después.
• En la liquidación se compara con otros usuarios que tuvieron la misma pregunta en el mismo periodo; si tu tasa de fallos reportada es claramente superior a la de ese periodo, el reembolso se calcula con la tasa de fallos del periodo.
• Si tienes dudas sobre una liquidación, puedes contactar con soporte para apelar.

En los tipos que devuelven token (reCAPTCHA, hCaptcha, Turnstile, FunCaptcha, etc.), el sitio de destino decide si el token es válido, por lo que el reporte no genera reembolso. Resumen de las reglas de cobro: Facturación y reembolso de puntos.