# report รายงานผลลัพธ์

> POST /report ใช้รายงานว่าผลลัพธ์ของงานถูกต้องหรือไม่ กรุณารายงานทั้งงานที่สำเร็จและล้มเหลวตามจริง งานการจดจำภาพที่รายงานว่าล้มเหลวภายใน 1 ชั่วโมงหลังสร้างงานจะคืนพอยต์หลังรายงานโดยสรุปผลประมาณ 24 ชั่วโมงต่อมา

Source: https://docs.yescaptcha.com/th/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` ใช้แจ้งให้เราทราบว่าผลลัพธ์ของงานกลุ่มหนึ่งถูกต้องหรือไม่ **กรุณารายงานทั้งงานที่สำเร็จและล้มเหลว** งานการจดจำภาพที่รายงานว่า “ผิดพลาด” และเข้าเงื่อนไขจะได้รับพอยต์คืนหลังผ่านไปประมาณ 24 ชั่วโมง นอกจากนี้ผลที่รายงานยังใช้ประเมินและปรับปรุงการจดจำด้วย

- POST `https://api.yescaptcha.com/report` (endpoint ทั่วโลก)
- POST `https://cn.yescaptcha.com/report` (endpoint จีน)

## พารามิเตอร์ของคำขอ

| ฟิลด์ | ประเภท | จำเป็น | คำอธิบาย |
| --- | --- | --- | --- |
| `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/th/help/contact.md)เพื่ออุทธรณ์ได้

ประเภทที่คืนค่า token (reCAPTCHA, hCaptcha, Turnstile, FunCaptcha เป็นต้น) เว็บไซต์เป้าหมายเป็นผู้ตัดสินว่า token ผ่านหรือไม่ การรายงานจึงไม่คืนพอยต์ สรุปกฎการเรียกเก็บเงินดูได้ที่ [การเรียกเก็บเงินและการคืนพอยต์](https://docs.yescaptcha.com/th/getting-started/billing.md)