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