TikTok Captcha

Gambaran Umum

TikTok Captcha adalah sistem verifikasi yang digunakan oleh TikTok untuk melindungi platform dari bot dan spam. Captcha ini biasanya muncul saat mendaftar akun baru, login, atau ketika aktivitas yang tidak biasa terdeteksi.

🎵

Saat ini, extension tersedia untuk semua 4 jenis captcha di browser. Silakan inbox admin untuk menerima extension. Menyediakan semua jenis captcha untuk browser, emulator, dan ponsel.

Rotate Captcha

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	TiktokCaptchaTask
`task.image`	string	ya	Base64 dari gambar
`task.subType`	int	ya	Jenis captcha: 0 (Rotate captcha di browser), 1 (Slider captcha), 2 (Pilih 2 objek serupa), 3 (Rotate captcha di ponsel, emulator), 5 (Pilih objek yang memenuhi pertanyaan)
`task.other`	string	tidak	Untuk subType 5, field ini diperlukan. Pertanyaan captcha, misalnya: "Which of these objects neighs"

Contoh Request

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

Response

Jika berhasil, server akan mengembalikan errorId = 0 dan taskId

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

Contoh Gambar untuk Dikirim ke Server Penyelesaian Captcha

Di browser:

Field image = base64_outer_image|base64_inner_image

Di emulator, ponsel:

Field image adalah base64 dari 1 gambar, dipotong untuk hanya berisi bagian rotate captcha (dengan kedua lingkaran, bisa ada ruang putih ekstra di margin, panjang margin fleksibel)

2. Dapatkan Hasil

Request

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

Parameter

Parameter	Tipe Data	Wajib?	Deskripsi
`clientKey`	string	ya	API key dari website
`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 rotate captcha di browser: mengembalikan panjang jarak drag slider
- Untuk rotate captcha di emulator, ponsel: mengembalikan sudut rotasi, pengguna menghitung jarak drag menggunakan rumus: Jarak drag = (L / 180) * solution (dimana L adalah jarak dari posisi awal ke akhir slider, diukur dari pusat slider)
- Untuk slider captcha: mengembalikan koordinat sumbu-x untuk drag
- Untuk pilih 2 objek serupa captcha: mengembalikan pasangan koordinat untuk klik pada gambar "x1,y1,x2,y2"
- Untuk pilih banyak objek yang memenuhi pertanyaan captcha: mengembalikan koordinat untuk klik pada gambar "x1,y1,x2,y2,x3,y3,..."

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, ikuti prinsip-prinsip berikut:

1. Identifikasi Jenis Captcha dan subType yang Benar

TikTok menggunakan berbagai jenis captcha
Deteksi dengan akurat jenis captcha yang ditampilkan
Kirim subType yang benar dalam request:
- 0: Rotate captcha di browser
- 1: Slider captcha
- 2: Pilih 2 objek serupa
- 3: Rotate captcha di ponsel, emulator
- 5: Pilih objek yang memenuhi pertanyaan (memerlukan field other)

2. Format Gambar dengan Benar

Rotate captcha di browser: Kirim base64_outer_image|base64_inner_image
Rotate captcha di ponsel/emulator: Kirim base64 dari 1 gambar (hanya berisi bagian rotate captcha)
Jenis lainnya: Kirim base64 dari gambar yang sesuai
Pastikan gambar diencode dalam format base64 yang benar

3. Tangani Hasil dengan Benar

Untuk rotate captcha di emulator/ponsel: Hitung jarak drag menggunakan rumus: Jarak drag = (L / 180) * solution
Ukur L seperti di atas: panjang untuk perhitungan drag
Untuk pilih objek captcha: Parse string koordinat "x1,y1,x2,y2" untuk mendapatkan titik klik
Untuk slider captcha: Gunakan koordinat x yang dikembalikan untuk drag slider

4. 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)

5. Penanganan Error

Periksa errorId = 1 dan status = processing untuk melanjutkan menunggu
Tangani error lainnya dengan tepat
Implementasikan logika retry untuk error sementara

6. Keamanan API Key

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

Link Berguna:

Captcha Geetest Captcha Shopee