Lewati ke konten
StatusDasbor

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.

POSThttps://api.yescaptcha.com/reportEndpoint global
POSThttps://cn.yescaptcha.com/reportEndpoint Tiongkok
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
}
{
"errorId": 0,
"status": "success"
}

Laporan dipakai untuk menghitung pengembalian poin sekaligus mengevaluasi dan meningkatkan pengenalan, jadi laporkan sesuai hasil sebenarnya:

  • Laporkan hasil yang benar dengan isSuccess: true dan yang salah dengan false. 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.
  • 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.