API Documentation

Kết nối với dịch vụ giải captcha thông qua REST API đơn giản

Mục lục
Tổng quan Xác thực BIDV API MB Bank API VCB API Lỗi & Status Code mẫu
Tổng quan

API sử dụng phương thức POST với dữ liệu dạng JSON hoặc form-data. Mọi yêu cầu đều cần xác thực bằng API Key.

Base URL
https://clonev6.shopcode.top/api/
Phương thức
POST
Content-Type
multipart/form-data
Phí mỗi request
5 đ / lần
Xác thực (Authentication)

Tất cả các request cần gửi kèm api_key trong body của request.

Không bao giờ để API Key trong mã nguồn client-side hoặc public repository. Mỗi request thành công sẽ trừ phí từ số dư tài khoản.
Parameters
api_key    (required) string  - API Key của bạn
img_base64 (required) string  - Ảnh captcha encode base64
BIDV Captcha API
Active
POST https://clonev6.shopcode.top/api/captcha.php?bank=bidv
Kích thước ảnh: 145×50px
Ký tự: a-z, 2-9
Độ chính xác: ~95%
Tốc độ: < 800ms
PHP
<?php
$curl = curl_init();
$dataPost = [
    "api_key"    => "YOUR_API_KEY_HERE",
    "img_base64" => base64_encode(file_get_contents("captcha.png")),
];
curl_setopt_array($curl, [
    CURLOPT_URL            => "https://clonev6.shopcode.top/api/captcha.php?bank=bidv",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_SSL_VERIFYPEER => false,
    CURLOPT_CUSTOMREQUEST  => "POST",
    CURLOPT_POSTFIELDS     => $dataPost,
]);
$response = curl_exec($curl);
curl_close($curl);
$result = json_decode($response, true);
// $result["captcha"] => "ab3k9"
echo $result["captcha"];
MB Bank Captcha API
Active
POST https://clonev6.shopcode.top/api/captcha.php?bank=mbbank
Kích thước ảnh: 320×80px
Ký tự: A-Z, a-z, 0-9, -
Độ chính xác: ~93%
Tốc độ: < 1000ms
Python
import requests, base64

with open("captcha.png", "rb") as f:
    img_b64 = base64.b64encode(f.read()).decode()

response = requests.post(
    "https://clonev6.shopcode.top/api/captcha.php?bank=mbbank",
    data={
        "api_key":    "YOUR_API_KEY_HERE",
        "img_base64": img_b64,
    }
)
result = response.json()
print(result["captcha"])  # e.g. "KmC3-Aq"
Vietcombank (VCB) Captcha API
Active
POST https://clonev6.shopcode.top/api/captcha.php?bank=vcb
Kích thước ảnh: 155×50px
Ký tự: 1-9 (chỉ số)
Độ chính xác: ~97%
Tốc độ: < 500ms
JavaScript (fetch)
// Node.js example
const fs = require('fs');
const FormData = require('form-data');

const form = new FormData();
form.append('api_key', 'YOUR_API_KEY_HERE');
form.append('img_base64', fs.readFileSync('captcha.png').toString('base64'));

const res = await fetch('https://clonev6.shopcode.top/api/captcha.php?bank=vcb', {
    method: 'POST',
    body: form
});
const data = await res.json();
console.log(data.captcha); // "94627"
Cấu trúc Response & Mã lỗi

Response thành công:

JSON
{
  "status":  "success",
  "captcha": "94627",
  "time_ms": 245
}

Response lỗi:

JSON
{
  "status":  "error",
  "message": "Insufficient balance",
  "code":    402
}
CodeMessageMô tả
200successGiải captcha thành công
400bad_requestThiếu tham số api_key hoặc img_base64
401unauthorizedAPI Key không hợp lệ hoặc bị vô hiệu hóa
402insufficient_balanceSố dư tài khoản không đủ
500server_errorLỗi máy chủ, vui lòng thử lại