Token hCAPTCHA

⚠️

Fitur penyelesaian Token hCaptcha saat ini belum didukung. Silakan periksa kembali nanti atau lihat Gambar hCaptcha!

Ikhtisar

Token hCaptcha adalah metode menyelesaikan hCaptcha dengan mendapatkan token autentikasi tanpa perlu berinteraksi dengan gambar. Ini adalah metode tercepat dan paling efisien untuk melewati hCaptcha.

🔐

Token hCaptcha banyak digunakan di berbagai situs web seperti Cloudflare, Discord, OpenSea, dan banyak layanan lainnya untuk melindungi dari bot.

1. Buat Tugas

Permintaan

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

Parameter

Nama Parameter	Tipe Data	Wajib?	Deskripsi
`clientKey`	string	ya	Kunci API
`task.type`	string	ya	HCaptchaTaskProxyless
`task.websiteURL`	string	ya	URL lengkap halaman yang memuat hCaptcha
`task.websiteKey`	string	ya	Site key hCaptcha (data-sitekey)

Contoh Permintaan

POST /createTask HTTP/1.1
Host: api.achicaptcha.com
Content-Type: application/json
 
{
  "clientKey": "KUNCI_API_ANDA",
  "task": {
    "type": "HCaptchaTaskProxyless",
    "websiteURL": "https://example.com",
    "websiteKey": "10000000-ffff-ffff-ffff-000000000001"
  }
}

Respons

Saat berhasil, server mengembalikan errorId = 0 dan taskId

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

2. Dapatkan Hasil

Permintaan

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

Parameter

Nama Parameter	Tipe Data	Wajib?	Deskripsi
`clientKey`	string	ya	Kunci API
`taskId`	string	ya	TaskId yang diperoleh dari (1)

Contoh Permintaan

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

Respons

{
  "errorId": 0,
  "status": "ready",
  "solution": "P1_eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.hKdwYXNza2V5xQbWjeEJ6Tk1wkaXoYkbJ-QT3vPKAXg2xbxRdxNPLFQlE4Dt2qJrlhsClaZ2dHmZ7IwoU6Wt8p7VDr6JCeco-KkjsEAHjYrCvuZ3xQnyr1VFjp_xq98KcdvmCUd7xrociy1smgTL2CsOVoe_kKfGJcMmjrzHf3fz3OLfhSKDeUtC3VdD6Lz2MHRpyb4rqIpJrCuZ1YGpeMNSWfGeIx1JlPrbC11ceQNJMl_hHhvn7HZ_8OZZKKdTfSX9e5RE8AHlzhqdqI6xHaveYKZC8PyrjRcNv1Ano5_ZXWFT-o3tlXIYZsICi1aStTk2prwIh5-jVnL2XGbWHYhDhQ6-oJGeHmQLoGm_B7dQ5BaPx9NC-x2ub3Az37QzUIi98yIw7Fv8mVYhO-ZQPN98iWojiYDscZ0WspIyD4wQyDgE37m6PWhx0WB0RYEN_bUOwtiZ_2CplM7uiH9VV5hvyEg-RpY_A494J5cAbaYVt2XsNLE0MPJqFRfXDhupzDlYxBIeb8k6QN9EDBj02dkFMKSl4DK8R8Rblm-B9socc39LpAj8eN4O15Fl6I01prM6oohrbBwhc_i0a_U22qnKs3uRQwUMTpCLixF4-C3Xqnk00l2HuNDXeh1wQx8SdYWrY7vk2Z_blsOYH4ty9-CvZAMbWI6mBD8BX1JK8L0hU3maFuSXPdBKvB-cfC_1TBeR7j5DIEKt2KuM74sr0BeneFAT2-jqDo1WDmPeLZBUaGb6MGwYDm6PK8U2BEzAs1SLhnnTIky90si443KQlnZFoe4RiiOIbvMd1l0r3B1OqEa4WAgRdh51fTTTj-kkPndvf59EfZrNmhLDcrdr1d-pkWyXhnzGIEXV8zK8VDzgBqm69pZ8CkmVLP3fhab6MXvLITmDRAxE7IQZfz4TfBjKgMCOk19cdgk1qFLQaVQ49yuGdflnB4-o4f7aC3ga7w9M3m-hAOy_mFweVrSVP9KxPVm5PZr1ocVb5y4wGYNfj2w9xYNew6oeFkW2jTOgElMJfrh7k7ZunHRsoF4fiixWM1Sv64yGVl3aV3xtrYfXDbiE3ycNpaSwn5nj_lqenaJ9KiYF9KfqPUYTsGEOun_8I1zeUyD6CSu0xDKHHMZ8gzXxOiB11EezdLn_agqneWbmD7UN9URXrgry_NSSrdmJe2ZM84smAgWxfCNvKIyC3lAXSaOcXOmGQTf35aQYARrAuII4gOxSwZXBGJWoKbZNFK_6pYKySB_OL_2s-Do0EdoL1Z1t0Y4FMKDZaZStwRA821kqfzqOLBbkVVhxvYZXvDFeNtBKYK09OmmhQ51bRyGSPEG4cGJ_xOBjepl9ITp6ZryAPDClelD5IKeCqenzKiEZZB0gEWBLNPgybBowc-tgj-iNRYK-Sy6gZ_bfIaepwoIguognuFCz1wufgSy8L_5M4ZcVjB-dhYt6ZrHyo95UakhQagIRFYY8QgOsyXsGC0WAv_6wV8vicwohMrapPbAUYmeCXIcMP7ad1aiaKlWnJuMTfrSd5kqkmhqpw4l4A2uZ87_wg3WGiTHCYid7MUPk9v1ADqGO27YwfBr1Q4gHVYVDRbP1oUKdN0MGrSu6Egg8jwI8gjYwZXckvjuP8DdWxPQwbfXceFASecaek1FZwuz6a1pFcMisAVS8K93iTQ40aacH4BQBM3-c9ggV4W9In6KoVED3huRapy6lvlscKTwKqRGf1P-mlcv17XRuQgXdTkCnHUMg3QrlDdPc4HFwGwG1EjFHiVl0uC3MWHMjNmRWP__t6u-lLhbjiYckMdjokwxbDpJI1lkywqkQ3XTHtWI9UeUfoUh4tvYWNLanRzrkStzHqC6VkHENMt92VmQXWbpY2bWf-gkaHYKyobbhKoHe0kPg66ahIsyP1VIhfsEARsKSzomo1HECydBObyZVnwnIheZSylJQnoax1cWtt-p5fjU-g6DDX-aqrxnAqTNRDk5DitCJBye-DCtuPKoIxnTfnebCOP5cFi2mpsJj45Ft8ILWwOATSZrifSKB4-QFWcv1HgCA8bjjiKPeUji2KxjnLH3T-btWnQgeen2xMy42mcPtiU9oKJaWqP2qQ-Z2HLk1ZDeUs8J9DNuWDMxq-v7r6CW2KAfDduFMp8eYHRwsFNnEwJD04Le4LzvQP1Xeqwz-uRVw_SrOlbs3m2qcR54o-217uAqRZyyNrwkk3naArZjtgkSvAd2HSbxYLojAd20PkFPC6XGCPvRxyi6iA5q3MNk7kFMU0J8bNyrcI0H8jlAzf-q9Fc1YaJqfks5Hajc5FRjqxOgu6zcevSKd0DV-2HCtjQpgLZqOH7hpfCmkAIsITgMSOxL-jaNleHDOY_TcJqhzaGFyZF9pZM4VmeRUonBkAA.cC-lgBWfBLBLEh-CBylsiYlwSQFX_Cl0Xdkx8yhoMGI"
}

Penjelasan Status

errorId = 0 dan status = ready: Berhasil diselesaikan, baca hasil di solution.gRecaptchaResponse
errorId = 0 dan status = processing: Sedang menyelesaikan captcha, tunggu 2 detik dan coba lagi
errorId > 0: Kesalahan sistem, mengembalikan kode dan deskripsi kesalahan

Contoh Integrasi

import requests
import time
 
def solve_hcaptcha_token(website_url, website_key, api_key='KUNCI_API_ANDA'):
    # Langkah 1: Buat tugas
    create_task_url = 'https://api.achicaptcha.com/createTask'
    create_task_payload = {
        'clientKey': api_key,
        'task': {
            'type': 'HCaptchaTaskProxyless',
            'websiteURL': website_url,
            'websiteKey': website_key
        }
    }
    
    response = requests.post(create_task_url, json=create_task_payload)
    result = response.json()
    
    if result['errorId'] != 0:
        raise Exception(result['errorDescription'])
    
    task_id = result['taskId']
    
    # Langkah 2: Dapatkan hasil
    get_result_url = 'https://api.achicaptcha.com/getTaskResult'
    
    while True:
        time.sleep(2)  # Tunggu 2 detik
        
        get_result_payload = {
            'clientKey': api_key,
            'taskId': task_id
        }
        
        response = requests.post(get_result_url, json=get_result_payload)
        result = response.json()
        
        if result['errorId'] != 0:
            raise Exception(result['errorDescription'])
        
        if result['status'] == 'ready':
            return result['solution']['gRecaptchaResponse']
        
        # Jika status == 'processing', lanjutkan loop
 
# Penggunaan
website_url = 'https://example.com'
website_key = '10000000-ffff-ffff-ffff-000000000001'
token = solve_hcaptcha_token(website_url, website_key, 'KUNCI_API_ANDA')
print('hCaptcha token:', token)

Kode Kesalahan Umum

Kode Kesalahan	Deskripsi	Catatan
0	sukses	Sukses
1	sedang memproses	Sedang memproses
2	bidang wajib hilang	Bidang wajib hilang, periksa parameter lagi
3	tugas tidak didukung	Jenis tugas tidak didukung
4	pembuatan tugas gagal	Pembuatan tugas gagal
5	kunci klien tidak ada	Kunci API tidak ada, periksa kunci API lagi
6	saldo akun tidak cukup	Saldo akun tidak cukup, tambahkan kredit lagi
7	tugas gagal, harap buat tugas baru	Tugas gagal, harap buat tugas baru
8	ID tugas tidak ada	ID tugas tidak ada

Praktik Terbaik

Untuk hasil terbaik saat menggunakan API Achicaptcha, ikuti prinsip-prinsip ini:

1. Validasi Site Key

Periksa site key sebelum mengirim permintaan
Pastikan site key yang diperoleh dari atribut data-sitekey akurat
Verifikasi URL situs web cocok dengan halaman yang memuat captcha

2. Tangani Waktu Habis (Timeouts)

Token memiliki waktu kedaluwarsa (biasanya 120 detik)
Gunakan token segera setelah diterima
Jangan cache token terlalu lama

3. Interval Polling

Tunggu setidaknya 2 detik di antara pemeriksaan hasil
Jangan spam API dengan terlalu banyak permintaan berturut-turut
Tetapkan batas waktu untuk menghindari loop tak terbatas (disarankan 120 detik)

4. Logika Percobaan Ulang

Terapkan percobaan ulang untuk kesalahan sementara seperti ERROR_NO_SLOT_AVAILABLE
Gunakan backoff eksponensial saat mencoba ulang
Batasi upaya percobaan ulang maksimum

5. Keamanan Kunci API

Jangan hardcode kunci API dalam kode
Gunakan variabel lingkungan
Jangan mengekspos kunci API di sisi klien

Tautan berguna:

Gambar Gambar