ข้ามไปยังเนื้อหา
สถานะแดชบอร์ด

เอกสารอ้างอิง API

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

หน้านี้แปลด้วยเครื่องจากเวอร์ชันภาษาจีน อาจมีข้อผิดพลาด โปรดยึดเวอร์ชันภาษาจีนเป็นหลัก

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

POSThttps://api.yescaptcha.com/reportendpoint ทั่วโลก
POSThttps://cn.yescaptcha.com/reportendpoint จีน
ฟิลด์ ประเภท จำเป็น คำอธิบาย
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 ชั่วโมงต่อมา
  • ตอนสรุปผล ระบบจะเปรียบเทียบกับผู้ใช้อื่นที่ทำคำถามเดียวกันในช่วงเวลาเดียวกัน หากอัตราความล้มเหลวที่รายงานสูงกว่าระดับของช่วงเวลาเดียวกันอย่างชัดเจน จะคืนพอยต์ตามอัตราความล้มเหลวของช่วงเวลาเดียวกัน
  • หากมีข้อสงสัยเกี่ยวกับการสรุปผล สามารถติดต่อฝ่ายสนับสนุนเพื่ออุทธรณ์ได้

ประเภทที่คืนค่า token (reCAPTCHA, hCaptcha, Turnstile, FunCaptcha เป็นต้น) เว็บไซต์เป้าหมายเป็นผู้ตัดสินว่า token ผ่านหรือไม่ การรายงานจึงไม่คืนพอยต์ สรุปกฎการเรียกเก็บเงินดูได้ที่ การเรียกเก็บเงินและการคืนพอยต์