Referensi API
report — laporkan hasil tugas
Halaman ini diterjemahkan otomatis dari versi bahasa Mandarin dan mungkin mengandung kesalahan. Versi bahasa Mandarin menjadi acuan utama.
report dipakai untuk memberi tahu kami apakah hasil sekelompok tugas benar atau tidak. Laporkan keberhasilan maupun kegagalan. Untuk jenis pengenalan gambar, tugas yang dilaporkan “salah” dan memenuhi syarat akan dikembalikan poinnya sekitar 24 jam kemudian; hasil laporan juga dipakai untuk mengevaluasi dan meningkatkan pengenalan.
https://api.yescaptcha.com/reportEndpoint globalhttps://cn.yescaptcha.com/reportEndpoint TiongkokParameter permintaan
Section titled “Parameter permintaan”| Field | Tipe | Wajib | Keterangan |
|---|---|---|---|
id |
array of string | Ya | Daftar ID tugas; bisa melaporkan beberapa sekaligus |
isSuccess |
boolean | Ya | true jika hasil benar, false jika hasil salah |
clientKey tidak diperlukan; ID tugas sudah cukup untuk mengidentifikasi tugasnya.
{ "id": ["610ff5e0-68eb-11ef-95a6-22e70a0b794d", "65b88c06-68eb-11ef-8e9a-52540023ccb3"], "isSuccess": false}Hasil yang dikembalikan
Section titled “Hasil yang dikembalikan”{ "errorId": 0, "status": "success"}Laporkan secara jujur
Section titled “Laporkan secara jujur”Laporan dipakai untuk menghitung pengembalian poin sekaligus mengevaluasi dan meningkatkan pengenalan, jadi laporkan sesuai hasil sebenarnya:
- Laporkan hasil yang benar dengan
isSuccess: truedan yang salah denganfalse. Laporan yang hanya berisi kegagalan, atau yang menandai semuanya gagal tanpa memedulikan hasil sebenarnya, tidak dijadikan acuan dalam statistik dan penyelesaian. - Tingkat kegagalan dihitung dari seluruh tugas yang Anda buat pada periode tersebut, bukan hanya tugas yang dilaporkan. Melaporkan lebih banyak kegagalan tidak menambah pengembalian poin: jika tingkat kegagalan Anda jelas lebih tinggi daripada periode yang sama, pengembalian poin hanya mengikuti tingkat kegagalan periode tersebut.
- Jika satu verifikasi memakai beberapa gambar (misalnya FunCaptcha yang meminta 5 ronde) dan Anda tidak tahu gambar mana yang salah, Anda bisa melaporkan seluruh kelompok tugas itu sebagai gagal; jika verifikasi lolos, laporkan seluruh kelompoknya sebagai berhasil dengan cara yang sama.
Pengembalian poin setelah laporan gagal
Section titled “Pengembalian poin setelah laporan gagal”- Hanya 5 jenis pengenalan gambar yang bisa mendapat pengembalian poin:
FunCaptchaClassification,HCaptchaClassification,ReCaptchaV2Classification,AwsClassification,bCaptchaClassification. - Hanya laporan yang dibuat dalam 1 jam setelah tugas dibuat yang diperhitungkan; satu tugas hanya dikembalikan poinnya satu kali.
- Pengembalian tidak dilakukan seketika, melainkan diselesaikan secara kolektif sekitar 24 jam kemudian.
- Saat penyelesaian, tingkat kegagalan yang Anda laporkan dibandingkan dengan pengguna lain pada periode dan pertanyaan yang sama; jika tingkat kegagalan Anda jelas lebih tinggi dari periode tersebut, pengembalian poin mengikuti tingkat kegagalan periode itu.
- Jika ada keberatan atas hasil penyelesaian, silakan ajukan banding melalui hubungi Dukungan.
Untuk jenis yang mengembalikan token (reCAPTCHA, hCaptcha, Turnstile, FunCaptcha, dan lainnya), lolos atau tidaknya ditentukan oleh situs tujuan, sehingga laporan tidak menghasilkan pengembalian poin. Ringkasan aturan penagihan ada di Penagihan dan pengembalian poin.