Shopee Captcha

Gambaran Umum

Shopee Captcha adalah sistem captcha yang digunakan oleh Shopee untuk melindungi pengguna dan sistem dari perilaku abnormal seperti bot, spam, atau login otomatis.

Achicaptcha mendukung penyelesaian captcha Shopee otomatis untuk berbagai platform (browser, emulator, ponsel). Lihat panduan di bawah ini untuk mengintegrasikan API.

🛍️

Untuk text captcha Shopee, silakan lihat Text Captcha. Jika Anda mengalami masalah, silakan hubungi admin (opens in a new tab) untuk dukungan.

1. Buat Task

Request

POST https://api.achicaptcha.com/createTask

Parameter

Parameter	Tipe Data	Wajib?	Deskripsi
`clientKey`	string	ya	API key
`task.type`	string	ya	ShopeeCaptchaTask
`task.image`	string	ya	Base64 gambar mask\|Base64 gambar background
`task.subType`	int	ya	Jenis captcha: 0: Slider captcha

Contoh Request

POST /createTask HTTP/1.1
Host: api.achicaptcha.com
Content-Type: application/json
 
{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "ShopeeCaptchaTask",
    "image": "/9j/4AAQSkZJRgABAQEASABIAAD...|/9j/4DSJFHKSDJDS...",
    "subType": 0
  }
}

Response

Jika berhasil, server akan mengembalikan errorId = 0 dan taskId

{
  "errorId": 0,
  "taskId": "f2fc70d6-c76b-4fba-9480-205ac1fe9fb9"
}

2. Dapatkan Hasil

Request

POST https://api.achicaptcha.com/getTaskResult

Parameter

Parameter	Tipe Data	Wajib?	Deskripsi
`clientKey`	string	ya	API key, hubungi admin
`taskId`	string	ya	TaskId dari langkah (1)

Contoh Request

POST /getTaskResult HTTP/1.1
Host: api.achicaptcha.com
Content-Type: application/json
 
{
  "clientKey": "Your API_KEY",
  "taskId": "f2fc70d6-c76b-4fba-9480-205ac1fe9fb9"
}

Response

{
  "errorId": 0,
  "status": "ready",
  "solution": "x1,y1,x2,y2"
}

Arti Response

errorId = 0 dan status = ready: Berhasil diselesaikan, baca hasil di solution
errorId = 1 dan status = processing: Captcha sedang diselesaikan, tunggu 1-2 detik dan coba lagi
errorId selain 0 dan 1: Kesalahan sistem, kode kesalahan dan deskripsi disediakan
solution: Untuk slider captcha: mengembalikan koordinat sumbu-x untuk drag

Contoh Integrasi

Lihat dokumentasi lengkap untuk contoh kode Python, JavaScript, dan PHP.

Kode Error Umum

Kode Error Saat Membuat Task

Kode Error	Deskripsi	Catatan
0	sukses	Task berhasil dibuat
2	field yang diperlukan hilang	Field yang diperlukan hilang, periksa parameter (image, subType)
3	task tidak didukung	Jenis task tidak didukung
4	pembuatan task gagal	Pembuatan task gagal, coba lagi nanti
5	client key tidak ada	API key tidak ada, periksa API key Anda
6	saldo akun tidak mencukupi	Saldo akun tidak mencukupi, tambahkan kredit

Kode Error Saat Mendapatkan Hasil

Kode Error	Deskripsi	Catatan
0	sukses	Sukses, baca hasil di field `solution`
1	memproses	Memproses, tunggu 1-2 detik dan kirim request lagi
5	client key tidak ada	API key tidak ada, periksa API key Anda
7	task gagal, silakan buat task baru	Task gagal, silakan buat task baru
8	task ID tidak ada	Task ID tidak ada atau telah kedaluwarsa

Praktik Terbaik

Untuk mencapai hasil terbaik saat menggunakan API Achicaptcha untuk Shopee Captcha, ikuti prinsip-prinsip berikut:

1. Persiapkan Gambar Base64

Konversi gambar mask dan background ke format Base64
Pastikan kualitas gambar jelas untuk meningkatkan akurasi
Hubungkan dua gambar dengan karakter | (pipe)

2. Interval Polling

Tunggu setidaknya 1-2 detik antara pemeriksaan hasil
Jangan spam API dengan terlalu banyak request berturut-turut
Miliki timeout untuk menghindari loop tak terbatas (disarankan 120 detik)

3. Penanganan Error

Periksa errorId untuk mendeteksi error
errorId = 0 dan status = ready: Sukses
errorId = 1: Memproses, lanjutkan polling
errorId selain 0 dan 1: Kesalahan sistem, perlu penanganan

4. Logika Retry

Implementasikan retry untuk error sementara
Gunakan exponential backoff saat retry
Batasi jumlah maksimum percobaan retry

5. Keamanan API Key

Jangan hardcode API key dalam kode
Gunakan environment variables
Jangan expose API key di sisi client

Link Berguna:

Captcha Tiktok Captcha Faucet