API inisialisasi CAPTCHA mengambil sumber daya CAPTCHA melalui permintaan yang menyertakan tag pengguna Anda (awalan). Permintaan dikirim ke xxxxx.captcha-open.aliyuncs.com, dengan xxxxx sebagai tag pengguna Anda. Untuk mengetahui tag pengguna Anda, lihat Aktifkan Layanan Captcha.
Respons inisialisasi yang berhasil tampak seperti berikut:
Kode kesalahan API
Jika inisialisasi gagal, API mengembalikan salah satu kode kesalahan berikut:
| Kode kesalahan | Tipe | Deskripsi dan perbaikan |
|---|---|---|
IllegalUserTag | Konfigurasi | Parameter tag pengguna (awalan) tidak valid. Lihat Aktifkan Layanan Captcha untuk memastikan nilai tersebut diteruskan dengan benar. Penting Kesalahan ini hanya berlaku untuk integrasi klien Web dan H5 serta integrasi klien App — tidak berlaku untuk integrasi program mini WeChat. |
IllegalCertifyId | Konfigurasi | Format certifyId (UserCertifyId) tidak valid. Format yang diperlukan adalah: [tag pengguna (awalan)]_[string 10 digit yang terdiri dari huruf kapital, huruf kecil, dan angka]. Untuk contoh kode, lihat Contoh kode parameter UserCertifyId. |
IllegalScene | Konfigurasi | Parameter ID adegan (SceneId) tidak valid. Pastikan nilai SceneId benar dan adegan tersebut dibuat di bawah akun yang terkait dengan tag pengguna (awalan). |
Forbidden.AccountAccessDenied | Akun | Akun memiliki pembayaran tertunda. Periksa apakah status akun Normal. |
Throttling | Pembatasan laju | Jumlah permintaan per detik (QPS) melebihi batas produk. Jika Anda memerlukan QPS yang lebih tinggi, hubungi manajer akun Anda terlebih dahulu untuk konfirmasi. |
ThrottlingByStrategy | Pembatasan laju | Batas laju permintaan inisialisasi telah dipicu. Ini merupakan mekanisme keamanan yang memblokir upaya menjelajahi pustaka soal CAPTCHA dengan mengirim permintaan pada frekuensi tinggi. |
Kesalahan validasi parameter
Jika nilai parameter tidak valid, inisialisasi gagal dengan kesalahan tingkat bidang. Tabel berikut mencantumkan setiap bidang yang terpengaruh beserta cara memperbaikinya:
| Bidang | Deskripsi dan perbaikan |
|---|---|
| Verifikasi tipe umum | Tipe parameter tidak valid. Lihat Deskripsi parameter dan teruskan nilai dengan tipe yang benar. |
language | Nilai parameter language tidak valid. Lihat Bahasa yang didukung oleh Captcha 2.0 untuk daftar nilai yang valid. |
region | Nilai parameter region tidak valid. Lihat deskripsi parameter region untuk persyaratannya. |
mode | Nilai parameter mode tidak valid. Nilai yang didukung adalah popup dan embed. Lihat deskripsi parameter mode untuk detailnya. |
element/button | Elemen element atau button tidak ada di halaman, atau nilai parameter tidak sesuai dengan pemilih ID elemen di halaman. Pastikan elemen tersebut ada dan parameter sesuai dengan pemilih ID-nya. |
Bidang | Pesan kesalahan |
Validasi tipe umum | Parameter input memiliki tipe data yang tidak valid. Lihat Deskripsi parameter untuk tipe data yang benar. |
language | Parameter |
region | Parameter |
mode | Parameter |
element/button | Parameter |