Tài liệu API Captcha

API Giải mã Captcha tự động

Hệ thống nhận dạng Captcha sử dụng trí tuệ nhân tạo hỗ trợ các ngân hàng BIDV, MBBank, Vietcombank

Xác thực API Token: Tất cả các request đều yêu cầu token xác thực. Token của bạn:
Xử lý nhanh
< 500ms
Độ chính xác cao
≥ 95%
CORS hỗ trợ
Đa nền tảng
24/7 Hoạt động
Uptime cao
POST GET /api/ecaptcha/bidv Yêu cầu API Token
Mô tả

Nhận diện Captcha của ngân hàng BIDV. Hỗ trợ cả 2 phương thức GET và POST. Ảnh captcha được chuyển tiếp đến backend giải mã.

Xác thực

Header yêu cầu:

Authorization: Bearer YOUR_TOKEN

Hoặc sử dụng query parameter: ?access_token=YOUR_TOKEN

Ví dụ request (cURL - POST)
curl -X POST https://ecaptcha.shopcode.top/api/ecaptcha/bidv \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d '{
    "base64": "iVBORw0KGgoAAAANSUhEUgAA..."
  }'
Ví dụ request (cURL - GET)
curl -X GET "https://ecaptcha.shopcode.top/api/ecaptcha/bidv?access_token=YOUR_TOKEN&base64=iVBORw0KGgoAAAANSUhEUgAA..."
Response mẫu
{
  "status": "success",
  "captcha": "8x7z9k",
  "cost": 2,
  "balance_remaining": 99998,
  "type": "bidv"
}
Lưu ý: Mỗi lần giải captcha thành công sẽ trừ tiền từ số dư tài khoản web.
POST GET /api/ecaptcha/mb Yêu cầu API Token
Mô tả

Nhận diện Captcha MBBank. Hỗ trợ cả 2 phương thức GET và POST.

Xác thực

Header yêu cầu:

Authorization: Bearer YOUR_TOKEN
Ví dụ request (cURL - POST)
curl -X POST https://ecaptcha.shopcode.top/api/ecaptcha/mb \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d '{
    "base64": "iVBORw0KGgoAAAANSUhEUgAA..."
  }'
Response mẫu
{
  "status": "success",
  "captcha": "M8K2Np",
  "cost": 2,
  "balance_remaining": 99996,
  "type": "mb"
}
POST GET /api/ecaptcha/vcb Yêu cầu API Token
Mô tả

Nhận diện Captcha Vietcombank. Hỗ trợ cả 2 phương thức GET và POST.

Xác thực

Header yêu cầu:

Authorization: Bearer YOUR_TOKEN
Ví dụ request (JavaScript)
const API_TOKEN = 'YOUR_TOKEN';

fetch('https://ecaptcha.shopcode.top/api/ecaptcha/vcb', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': `Bearer ${API_TOKEN}`
  },
  body: JSON.stringify({
    base64: 'iVBORw0KGgoAAAANSUhEUgAA...'
  })
})
.then(res => res.json())
.then(data => {
  console.log('Captcha:', data.captcha);
  console.log('Số dư còn lại:', data.balance_remaining);
});
Response mẫu
{
  "status": "success",
  "captcha": "827395",
  "cost": 2,
  "balance_remaining": 99994,
  "type": "vcb"
}
API bổ trợ
Endpoint Method Mô tả Ví dụ
/api/ecaptcha/balance GET/POST Kiểm tra số dư tài khoản https://ecaptcha.shopcode.top/api/ecaptcha/balance?access_token=TOKEN
Thông số kỹ thuật
Method POST GET
Authentication Bearer Token hoặc access_token query parameter
Content-Type application/json
Input format Base64 encoded image
Chi phí mỗi lần 2đ / lần giải
Response time 200-500ms
Chống trùng lặp Hỗ trợ request_id để tránh trừ tiền nhiều lần
Lưu ý khi tích hợp
API Token bắt buộc phải có trong header Authorization hoặc query parameter
Thêm request_id để tránh trừ tiền nhiều lần khi reload
Mỗi lần giải thành công tự động trừ tiền từ số dư tài khoản web
Xem lịch sử giải captcha tại: https://ecaptcha.shopcode.top/ecaptcha/history
Mã lỗi & Xử lý
HTTP Status Mô tả Giải pháp
401 Unauthorized - Token không hợp lệ hoặc thiếu Kiểm tra header Authorization: Bearer [token]
402 Insufficient balance - Số dư không đủ Nạp thêm tiền vào tài khoản
400 Bad Request - Thiếu base64 hoặc type không hợp lệ Kiểm tra payload phải có key "base64"
500 Lỗi xử lý captcha từ backend Thử lại sau vài giây
503 Captcha service unavailable Liên hệ admin để kiểm tra
200 Thành công, captcha trong response Lấy giá trị captcha để sử dụng
Base URL: https://ecaptcha.shopcode.top/api/ecaptcha (Sử dụng endpoint này cho tất cả API calls)