Halaman verifikasi Cloudflare

Halaman verifikasi Cloudflare adalah halaman pemeriksaan yang menghalangi seluruh halaman situs dan menampilkan “Mohon tunggu…” atau “Memeriksa browser Anda”. YesCaptcha membuka halaman melalui proxy yang Anda berikan, melewati pemeriksaan, lalu mengembalikan Cookie seperti cf_clearance, User-Agent yang dipakai saat itu, request header, response header, dan HTML halaman setelah lolos. CloudFlareTaskS2 per tugas 25 poin (≈ $3.75 / 1k), CloudFlareTaskS3 per tugas 20 poin (≈ $3.00 / 1k); kedua jenis memiliki parameter, hasil, dan efektivitas yang sama, hanya harganya yang berbeda. Hasil dikembalikan secara asinkron, satu tugas umumnya memakan 6 hingga 35 detik, dan bervariasi cukup besar antarsitus. Jika gagal atau timeout, poin dikembalikan otomatis.

POSThttps://api.yescaptcha.com/createTaskEndpoint globalSalin

POSThttps://cn.yescaptcha.com/createTaskEndpoint TiongkokSalin

Kapan dipakai

• Kode sumber halaman berisi __cf_chl_rt_tk atau cdn-cgi/challenge-platform, dan judulnya Just a moment... / “Mohon tunggu”: ini adalah halaman verifikasi Cloudflare. Halaman pemeriksaan yang meminta Anda mencentang kotak “Verifikasi bahwa Anda manusia” juga ditangani di halaman ini.
• Jika hanya ada kotak verifikasi Cloudflare yang tertanam di formulir: itu Turnstile, bukan halaman ini.
• Jika permintaan dengan library seperti requests mengembalikan 403 dan “Just a moment…”, padahal browser bisa membukanya langsung: kemungkinan besar hanya TLS fingerprint yang diblokir. Ganti dengan library yang dapat meniru TLS fingerprint browser (seperti curl_cffi), maka permintaan bisa berhasil tanpa perlu melewati verifikasi.

Jenis dan harga

Jenis tugas	Harga	Mode	Catatan
CloudFlareTaskS2	$3.75 / 1k; 25 poin/tugas · ¥25 / 1k	Asinkron	Proxy sendiri
CloudFlareTaskS3	$3.00 / 1k; 20 poin/tugas · ¥20 / 1k	Asinkron	Proxy sendiri

Harga dalam dolar AS adalah perkiraan dengan kurs US$1 ≈ ¥6.67; tugas ditagih dalam poin.

Parameter permintaan

Kolom	Tipe	Wajib	Deskripsi
type	string	Ya	Jenis tugas; lihat "Jenis tugas dan harga" di halaman ini
websiteURL	string	Ya	URL lengkap halaman yang berada di balik halaman verifikasi. Harus berupa URL publik berawalan http:// atau https://; alamat IP privat serta nama host lokal atau internal seperti localhost akan ditolak
proxy	string	Ya	Proxy dalam satu string: http://user:[email protected]:8080 (proxy HTTP, kredensial opsional) atau socks5://proxy.example.com:1080 (tanpa kredensial). Proxy https:// dan SOCKS5 dengan kredensial tidak didukung, serta alamat lokal atau privat ditolak. Semua permintaan untuk halaman target melewati proxy ini
userAgent	string	Tidak	Biasanya tidak perlu diisi. Hanya User-Agent Chrome desktop di Linux yang dipakai; yang lain (Windows, macOS, seluler, browser lain) diabaikan. Untuk permintaan berikutnya, selalu gunakan user_agent dari hasil
waitLoad	boolean	Tidak	Default false. Jika true, setelah lolos verifikasi tugas menunggu hingga aktivitas jaringan halaman mereda sebelum mengembalikan hasil, sehingga content berisi lebih banyak konten yang dimuat secara dinamis; butuh beberapa detik lebih lama
requiredCookies	array	Tidak	Daftar nama Cookie yang wajib didapat, berupa array string, misalnya ["cf_clearance"]. Jika diisi, tugas hanya berhasil bila semuanya didapat; jika tidak, tugas mengembalikan ERROR_CAPTCHA_UNSOLVABLE dan poin dikembalikan. Jika tidak diisi, tugas tetap berusaha mendapatkan cf_clearance, tetapi dianggap berhasil (dan poin dipotong) dengan Cookie lain yang didapat, jadi isi secara eksplisit jika Anda membutuhkan cf_clearance
blockImage	boolean	Tidak	Jika true, gambar di halaman target tidak dimuat (kecuali yang dibutuhkan oleh verifikasi Cloudflare itu sendiri), sehingga menghemat lalu lintas proxy
postData	object	Tidak	Jika diisi, data dikirim ke websiteURL sebagai POST formulir HTML biasa (application/x-www-form-urlencoded): setiap key adalah satu field formulir dan nilainya dikirim sebagai string, misalnya {"name": "hi"}. Harus berupa objek

Persyaratan proxy

proxy wajib diisi, dan semua permintaan untuk membuka halaman target melewati proxy ini. cf_clearance terikat pada IP keluar, jadi akses berikutnya ke situs target juga harus memakai proxy yang sama.

Format	Didukung
http://user:[email protected]:8080	Didukung: proxy http dengan akun dan kata sandi
http://proxy.example.com:8080	Didukung: proxy http tanpa akun dan kata sandi
socks5://proxy.example.com:1080	Didukung: proxy socks5 tanpa akun dan kata sandi; socks5h:// diperlakukan sebagai socks5://
socks5://user:[email protected]:1080	Tidak didukung, mengembalikan ERROR_PROXY_INCORRECT; jika memerlukan akun dan kata sandi, gunakan proxy http
https://proxy.example.com:443 atau protokol lain, atau tanpa port	Tidak didukung, mengembalikan ERROR_PROXY_INCORRECT
Alamat lokal, jaringan internal, atau alamat yang dicadangkan seperti 127.0.0.1, 192.168.x.x, 10.x.x.x, atau domain yang diresolusi ke alamat tersebut	Ditolak, mengembalikan ERROR_PROXY_BANNED

Diperiksa saat tugas dibuat

Jika URL atau proxy tidak valid, createTask langsung mengembalikan error dan tidak ada pemotongan poin. Jika sebuah proxy gagal terhubung beberapa kali dalam waktu singkat, membuat tugas dengan proxy itu juga akan langsung mengembalikan ERROR_PROXY_BANNED selama beberapa waktu; gunakan proxy lain atau coba lagi nanti.

User-Agent

Umumnya tidak perlu mengirim userAgent. Kami lulus verifikasi dengan Chrome desktop di Linux, sehingga hanya User-Agent Chrome desktop di Linux yang dipakai; yang lain (Windows, macOS, ponsel, atau browser lain) diabaikan: dalam pengujian, verifikasi Cloudflare tidak lolos jika lingkungan browser sebenarnya tidak cocok dengan User-Agent. Untuk semua permintaan berikutnya, selalu gunakan user_agent dari hasil.

Contoh permintaan

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

{
  "clientKey": "YOUR_CLIENT_KEY",
  "task": {
    "type": "CloudFlareTaskS3",
    "websiteURL": "https://example.com/",
    "proxy": "http://user:[email protected]:8080",
    "requiredCookies": ["cf_clearance"]
  }
}

• Untuk memakai CloudFlareTaskS2, ubah type saja, yang lain tetap.
• Jika requiredCookies diisi ["cf_clearance"], tugas gagal dan poin dikembalikan bila cf_clearance tidak didapat; jika tidak diisi, tugas yang hanya mendapat Cookie lain tanpa cf_clearance tetap dianggap berhasil dan poin dipotong.
• Untuk mengirim formulir, tambahkan postData, misalnya {"name": "hi"}; data dikirim ke websiteURL sebagai formulir POST.

Setelah tugas dibuat, panggil getTaskResult setiap 5 detik; alurnya sama seperti tugas asinkron lainnya, lihat getTaskResult.

Hasil

{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "user_agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/155.0.0.0 Safari/537.36",
    "cookies": {
      "cf_clearance": "Wq3vXk9...-1760860800-1.2.1.1-..."
    },
    "request_headers": {
      "accept-language": "en-US,en;q=0.9",
      "user-agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/155.0.0.0 Safari/537.36"
    },
    "headers": {
      "content-type": "text/html; charset=UTF-8",
      "server": "cloudflare"
    },
    "content": "<!DOCTYPE html>..."
  }
}

Nilai Cookie dan request header di atas hanya ilustrasi; yang berlaku adalah yang dikembalikan API.

Kolom	Tipe	Deskripsi
cookies	object	Semua cookie di browser setelah lolos verifikasi (objek nama ke nilai), biasanya termasuk cf_clearance; jika Anda mengisi requiredCookies, setiap cookie di dalamnya pasti disertakan. Gunakan bersama user_agent yang dikembalikan dan proxy yang Anda berikan
user_agent	string	User-Agent yang sebenarnya digunakan browser untuk lolos verifikasi (Chrome desktop di Linux). cf_clearance terikat dengannya, jadi gunakan untuk semua permintaan berikutnya
request_headers	object	Header permintaan yang dikirim browser pada permintaan terakhirnya ke halaman target; gunakan kembali pada permintaan berikutnya
headers	object	Header respons halaman target setelah lolos verifikasi
content	string	Sumber HTML halaman target setelah lolos verifikasi

Cara memakai hasil

1. Untuk permintaan berikutnya, gunakan cookies yang dikembalikan, user_agent yang dikembalikan, dan proxy yang sama dengan saat membuat tugas. cf_clearance terikat pada User-Agent dan IP keluar; jika salah satu dari ketiganya tidak cocok, halaman verifikasi Cloudflare muncul lagi.
2. Sertakan request header sesuai request_headers sebisa mungkin, dan gunakan TLS fingerprint yang sama dengan browser (misalnya parameter impersonate di curl_cffi).
3. cf_clearance memiliki masa berlaku (ditetapkan oleh situs target, di beberapa situs hingga 1 jam). Selama masa berlaku, Anda tidak perlu melewati verifikasi lagi; frekuensi permintaan yang terlalu tinggi dapat membuat IP diblokir oleh Cloudflare.
4. Jika hanya membutuhkan konten halaman, langsung gunakan content, tidak perlu meminta halaman sekali lagi.

Error umum

Error yang dikembalikan saat membuat tugas tidak dipotong poinnya; tugas yang gagal atau timeout setelah berhasil dibuat mendapat pengembalian poin otomatis. API hanya mengembalikan kode error dan keterangan umum, sehingga penyebab sebenarnya dapat dilihat pada tabel berikut.

Kode error	Kapan dikembalikan	Yang perlu dilakukan
ERROR_REQUIRED_FIELDS	Saat membuat tugas: websiteURL atau proxy tidak ada	Lengkapi kedua field wajib
ERROR_ILLEGAL_PARAMETERS	Saat membuat tugas: websiteURL bukan URL publik berawalan http:// / https://, postData bukan objek, atau requiredCookies bukan array string. Saat memeriksa hasil: domain target tidak dapat diresolusi melalui proxy	Perbaiki parameter; periksa penulisan URL dan apakah proxy dapat mengakses situs tersebut
ERROR_PROXY_INCORRECT	Saat membuat tugas: format proxy salah, tidak ada port, memakai proxy https://, atau socks5 dengan akun dan kata sandi	Ubah sesuai format pada “Persyaratan proxy” di atas; jika memerlukan akun dan kata sandi, gunakan proxy http
ERROR_PROXY_BANNED	Saat membuat tugas: proxy adalah alamat lokal, jaringan internal, atau alamat yang dicadangkan, atau proxy ini gagal terhubung beberapa kali dalam waktu singkat. Saat memeriksa hasil: Cloudflare situs target langsung memblokir IP proxy ini (halaman “Sorry, you have been blocked” atau “Access denied”)	Ganti proxy; semakin baik kualitas IP, semakin mudah lolos
ERROR_PROXY_CONNECT_REFUSED	Tidak dapat terhubung ke proxy (koneksi ditolak, domain proxy tidak dapat diresolusi), atau koneksi ditolak atau direset saat membuka halaman melalui proxy	Periksa alamat dan port proxy, pastikan proxy online dan mengizinkan akses dari luar; jika masih gagal, ganti proxy
ERROR_PROXY_CONNECT_TIMEOUT	Timeout saat terhubung ke proxy atau saat membuka halaman melalui proxy	Gunakan proxy yang lebih cepat dan stabil
ERROR_PROXY_NOT_AUTHORISED	Akun atau kata sandi proxy salah	Periksa akun dan kata sandi di proxy; karakter khusus harus di-URL-encode
ERROR_PROXY_TLS_ERROR	Handshake TLS gagal saat membuka halaman melalui proxy	Pastikan alamat, port, dan protokol proxy tidak salah; jika masih gagal, ganti proxy
ERROR_CAPTCHA_UNSOLVABLE	Verifikasi tidak lolos dalam waktu yang ditentukan, halaman masih berupa halaman pemeriksaan setelah lolos, atau Cookie yang diminta di requiredCookies tidak didapat	Coba lagi dengan proxy lain; untuk situs tertentu, hubungi dukungan
ERROR_NO_SLOT_AVAILABLE	Saat membuat tugas: antrean penuh. Saat memeriksa hasil: antrean terlalu lama dan belum dimulai, poin sudah dikembalikan	Tunggu beberapa detik, lalu buat tugas lagi
ERROR_TASK_TIMEOUT	Tugas tidak selesai dalam waktu yang ditentukan	Buat tugas baru; timeout yang terus berulang umumnya berarti proxy terlalu lambat

Daftar lengkap kode error ada di Kode error.

Terkait

• Mengenali jenis captcha: perbedaan halaman verifikasi Cloudflare dan Turnstile
• Cloudflare Turnstile