Captcha chữ

Captcha thông thường là một hình ảnh có chứa văn bản bị bóp méo nhưng con người có thể đọc được. Để giải quyết hình ảnh xác thực, người dùng phải nhập văn bản từ hình ảnh. Trông giống như những hình ảnh dưới đây

Hình ảnh minh hoạ

1. Tạo yêu cầu

Request

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

Tên param	Kiểu dữ liệu	Bắt buộc?	Mô tả
clientKey	string	yes	Api key
task.type	string	yes	ImageToTextTask
task.image	string	yes	base64 của hình ảnh
task.subType	string	yes	Là một trong các loại: common amazon microsoft facebook garena artistshot gmx 11166 houssam

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

{
	"clientKey": "API_KEY của bạn",
	"task": {
		"type": "ImageToTextTask",
		"image": "base64 encoded của ảnh",
		"subType": "gmx"
	}
}

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 http://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",
	"taskId": "f2fc70d6-c76b-4fba-9480-205ac1fe9fb9"
}

Response

Thành công

{
	"errorId": 0,
	"status": "ready",
	"solution": "swamn"
}

Đang xử lý

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

Thất bại

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

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

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

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