hCAPTCHA Token

hCaptcha là một loại hình ảnh xác thực khá mới, thực sự giống với reCAPTCHA và trông như thế này:

HCaptcha

Trước tiên, bạn cần tìm giá trị của tham số data-sitekey trong mã nguồn của trang.

1. Tạo yêu cầu

Request

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

Tên param	Kiểu dữ liệu	Bắt buộc?	Mô tả
clientKey	string	yes	Api key, liên hệ admin
task.type	string	yes	HCaptchaTaskProxyless
task.websiteURL	string	yes	Địa chỉ trang web chứa captcha
task.websiteKey	string	yes	hCaptcha sitekey

POST /createTask HTTP/1.1
Host: api.achicaptcha.com
Content-Type: application/json

{
	"clientKey": "YOUR_API_KEY",
	"task": {
		"type": "HCaptchaTaskProxyless",
		"websiteURL": "https://discord.com/"
		"websiteKey": "00000000-0000-0000-0000-000000000000"
	}
}

Response

Thành công

Khi thành công, server sẽ trả về errorId = 0 và taskId

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

Lỗi request

Server sẽ trả về errorId > 0 and errorCode

{
	"errorId": 1,
	"errorCode": "ERROR_KEY_DOES_NOT_EXIST",
	"errorDescription": "ERROR_KEY_DOES_NOT_EXIST"
}

2. Lấy kết quả

Request

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

Tên param	Kiểu dữ liệu	Bắt buộc?	Mô tả
clientKey	string	yes	Api key, liên hệ admin
taskId	string	yes	TaskId lấy từ (1)

POST /getTaskResult HTTP/1.1
Host: api.achicaptcha.com
Content-Type: application/json

{
	"clientKey": "API_KEY của bạn, liên hệ admin để lấy api key",
	"taskId": "f2fc70d6-c76b-4fba-9480-205ac1fe9fb9"
}

Response

Thành công

{
	"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"
}

Đang xử lý

{
	"errorId": 0,
	"status": "processing"
}

Thất bại

{
	"errorId": 1,
	"errorCode": "ERROR_CAPTCHA_UNSOLVABLE",
	"errorDescription": "ERROR_CAPTCHA_UNSOLVABLE"
}

Ý nghĩa kết quả trả về:

• errorId = 0 và status = ready : Giải thành công, đọc kết quả trong solution

• errorId = 0 và status = processing: Đang giải captcha, đợi 2-3 giây rồi thử lại

• errorId > 0: Lỗi hệ thống, đưa ra mã lỗi và mô tả lỗi

• solution: Token sử dụng để giải Hcaptcha