Saat Captcha 2.0 menyelesaikan verifikasi perilaku dalam arsitektur klien V3, sistem mengembalikan respons yang berisi hasil verifikasi dan kode status. Gunakan tab Network di developer tools browser Anda untuk memeriksa data yang dikembalikan selama integrasi dan pengujian.
Penting
Kode verifikasi hanya dapat dikirimkan satu kali. Catatan inisialisasi kedaluwarsa setelah 20 menit — kirim permintaan inisialisasi baru jika interval tersebut terlampaui.
Struktur respons
Respons terdiri dari dua tingkat: envelope respons HTTP dan objek Result yang bersarang di dalam body HTTP.
Parameter respons HTTP
| Parameter | Tipe | Deskripsi |
|---|---|---|
| Kode status HTTP | Integer | Kode status HTTP. Untuk detailnya, lihat Kode status HTTP. |
| RequestId | String | ID permintaan. |
| Success | Boolean | Apakah permintaan API berhasil. true: permintaan diproses. false: permintaan gagal. |
| Code | String | Kode respons. Untuk detailnya, lihat Kode status HTTP. |
| Message | String | Pesan detail. Untuk detailnya, lihat Kode status HTTP. |
Parameter Result
| Parameter | Tipe | Deskripsi |
|---|---|---|
| VerifyResult | Boolean | Hasil verifikasi. true: verifikasi berhasil. false: verifikasi gagal. |
| VerifyCode | String | Kode verifikasi yang menunjukkan hasil spesifik. Lihat Nilai VerifyCode di bawah ini. |
Nilai VerifyCode
Nilai VerifyCode yang diawali dengan T menunjukkan verifikasi berhasil. Nilai yang diawali dengan F menunjukkan verifikasi gagal.
Kode sandi
| VerifyCode | Deskripsi | Aksi |
|---|---|---|
T001 | Verifikasi klien berhasil. | Izinkan operasi dilanjutkan. |
T005 | Mode uji aktif dan dikonfigurasi agar verifikasi berhasil. | Jika tidak diharapkan, masuk ke Konsol Captcha 2.0 untuk memeriksa status kebijakan skenario Anda. Lihat Panduan integrasi untuk detailnya. |
T006 | Permintaan sesuai dengan kebijakan daftar putih dan verifikasi berhasil. | Jika tidak diharapkan, masuk ke Konsol Captcha 2.0 untuk meninjau kebijakan daftar putih Anda. |
Kode kegagalan
| VerifyCode | Deskripsi | Aksi |
|---|---|---|
F001 | Diduga serangan — permintaan gagal dalam pemeriksaan kebijakan risiko. | Blokir operasi. Kirim tiket jika lalu lintas sah diblokir. |
F004 | Mode uji aktif dan dikonfigurasi agar verifikasi gagal. | Jika tidak diharapkan, masuk ke Konsol Captcha 2.0 untuk memeriksa status kebijakan skenario Anda. Lihat Manajemen skenario untuk detailnya. |
F008 | Pengiriman ganda — data verifikasi untuk kode ini telah dikirim sebelumnya. | Setiap kode verifikasi hanya dapat dikirim satu kali. Minta pengguna untuk refresh dan menyelesaikan CAPTCHA lagi. |
F009 | Lingkungan perangkat virtual terdeteksi (mesin virtual seperti VMware, VirtualBox, Hyper-V, atau Parallels; emulator seperti AVD, BlueStacks, atau VBox/Hyper-V; atau browser desktop yang menyamar sebagai perangkat seluler). | Blokir operasi, atau masuk ke Konsol Captcha 2.0 untuk menonaktifkan pemeriksaan ini dalam kebijakan kustom Anda. Lihat Menetapkan kebijakan kustom untuk detailnya. |
F010 | Frekuensi akses dari alamat IP yang sama melebihi batas. | Masuk ke Konsol Captcha 2.0 untuk mengonfigurasi ambang batas frekuensi kustom dalam kebijakan kustom Anda. Lihat Menetapkan kebijakan kustom untuk detailnya. |
F011 | Frekuensi akses dari perangkat yang sama melebihi batas. | Masuk ke Konsol Captcha 2.0 untuk mengonfigurasi ambang batas frekuensi kustom dalam kebijakan kustom Anda. Lihat Menetapkan kebijakan kustom untuk detailnya. |
F014 | Catatan inisialisasi tidak ditemukan. Dua penyebab: (1) Interval antara permintaan inisialisasi dan verifikasi melebihi 20 menit — catatan tersebut dihapus oleh backend. (2) Tidak ada permintaan inisialisasi yang dikirim sebelum permintaan verifikasi — hal ini mungkin mengindikasikan serangan yang dicurigai atau kesalahan integrasi. | Untuk penyebab 1, kirim permintaan inisialisasi baru dan coba lagi. Untuk penyebab 2, kirim permintaan inisialisasi klien sebelum setiap permintaan verifikasi. |
F015 | Interaksi verifikasi gagal — misalnya, potongan puzzle tidak dipindahkan ke posisi yang benar. | Minta pengguna untuk refresh CAPTCHA dan menyelesaikan interaksi lagi. |
F016 | Permintaan diblokir oleh kebijakan verifikasi URL yang dikonfigurasi di Konsol. | Masuk ke Konsol Captcha 2.0 untuk menyesuaikan kebijakan verifikasi URL dalam kebijakan kustom Anda. Lihat Menetapkan kebijakan kustom untuk detailnya. |
F017 | Diduga serangan — permintaan gagal karena protokol atau parameter tidak normal. | Blokir operasi. |
Kode status HTTP
| Kode status HTTP | Code | Message |
|---|---|---|
| 200 | Success | Operasi berhasil. |
| 400 | MissingParameter | Parameter yang diperlukan tidak tersedia. |
| 401 | InvalidParameter | Parameter tidak valid. |
| 403 | Forbidden.AccountAccessDenied | Anda tidak memiliki izin. Layanan mungkin belum diaktifkan, atau akun Anda memiliki pembayaran tertunda. |
| 403 | Forbidden.RAMUserAccessDenied | Pengguna Resource Access Management (RAM) tidak memiliki izin. Berikan izin AliyunYundunAFSFullAccess. Lihat Grant permissions to a RAM role untuk detailnya. |
| 500 | InternalError | Terjadi error sistem internal. Coba ulang operasi. Jika error tetap terjadi, kirim tiket untuk mendapatkan dukungan. |