public/docs.html

<!DOCTYPE html>
<html lang="vi">

<head>
  <meta charset="UTF-8" />
  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
  <title>API Documentation - Professional Captcha Solver</title>
  <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/css/bootstrap.min.css" rel="stylesheet" />
  <link rel="stylesheet"
    href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0/styles/atom-one-dark.min.css" />
  <style>
    body {
      background-color: #0d1117;
      color: #c9d1d9;
      font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica,
        Arial, sans-serif;
    }

    .sidebar {
      position: fixed;
      top: 0;
      bottom: 0;
      left: 0;
      z-index: 100;
      padding: 48px 0 0;
      box-shadow: inset -1px 0 0 rgba(255, 255, 255, 0.1);
      width: 280px;
      background-color: #161b22;
    }

    .sidebar-sticky {
      position: relative;
      top: 0;
      height: calc(100vh - 48px);
      padding-top: 0.5rem;
      overflow-x: hidden;
      overflow-y: auto;
    }

    .nav-link {
      font-weight: 500;
      color: #8b949e;
      margin-bottom: 5px;
    }

    .nav-link:hover,
    .nav-link.active {
      color: #58a6ff;
      background-color: rgba(255, 255, 255, 0.05);
      border-radius: 6px;
    }

    main {
      margin-left: 280px;
      padding: 40px;
    }

    h1,
    h2,
    h3 {
      color: #ffffff;
      margin-top: 40px;
      margin-bottom: 20px;
      border-bottom: 1px solid #30363d;
      padding-bottom: 10px;
    }

    h1 {
      margin-top: 0;
      border: none;
    }

    .card {
      background-color: #161b22;
      border: 1px solid #30363d;
      margin-bottom: 20px;
    }

    .card-header {
      background-color: #21262d;
      border-bottom: 1px solid #30363d;
      font-weight: bold;
      color: #fff;
    }

    code {
      color: #ff7b72;
      word-wrap: break-word;
    }

    pre {
      background-color: #0d1117;
      border-radius: 6px;
      padding: 15px;
      border: 1px solid #30363d;
    }

    .badge-method {
      background: #238636;
      color: white;
      padding: 5px 10px;
      border-radius: 4px;
      font-weight: bold;
    }

    .table {
      color: #c9d1d9;
    }

    .table-dark {
      --bs-table-bg: #161b22;
    }

    .api-endpoint {
      background: #161b22;
      padding: 15px;
      border-radius: 6px;
      border: 1px solid #30363d;
      font-family: monospace;
      font-size: 1.1em;
      color: #a5d6ff;
    }

    .highlight-box {
      background: rgba(56, 139, 253, 0.1);
      border-left: 4px solid #58a6ff;
      padding: 15px;
      margin: 20px 0;
      border-radius: 0 6px 6px 0;
    }

    .step-badge {
      display: inline-block;
      width: 24px;
      height: 24px;
      background: #58a6ff;
      color: #0d1117;
      border-radius: 50%;
      text-align: center;
      line-height: 24px;
      font-weight: bold;
      margin-right: 10px;
    }
  </style>
</head>

<body>
  <nav class="sidebar">
    <div class="position-sticky sidebar-sticky px-3">
      <h4 class="text-white px-3 mb-4">📚 API Docs</h4>
      <ul class="nav flex-column">
        <li class="nav-item">
          <a class="nav-link active" href="#intro">Giới thiệu</a>
        </li>
        <li class="nav-item">
          <a class="nav-link" href="#auth">Xác thực (Auth)</a>
        </li>
        <li class="nav-item">
          <a class="nav-link" href="#endpoint">API Endpoint</a>
        </li>
        <li class="nav-item">
          <a class="nav-link" href="#proxy">Cấu hình Proxy</a>
        </li>
        <li class="nav-item">
          <a class="nav-link" href="#integration">Quy trình Tích hợp</a>
        </li>
        <li class="nav-item">
          <a class="nav-link" href="#nodejs">Code mẫu: Node.js</a>
        </li>
        <li class="nav-item">
          <a class="nav-link" href="#python">Code mẫu: Python</a>
        </li>
        <li class="nav-item">
          <a class="nav-link" href="#csharp">Code mẫu: C#</a>
        </li>
      </ul>
      <div class="mt-5 px-3">
        <a href="/" class="btn btn-outline-primary w-100">← Quay lại Dashboard</a>
      </div>
    </div>
  </nav>

  <main>
    <section id="intro">
      <h1>Giới thiệu</h1>
      <p class="lead">
        Enterprise Captcha Solver cung cấp giải pháp tự động vượt qua các hệ thống bảo mật captcha tiên tiến nhất hiện
        nay.
      </p>
      <div class="highlight-box">
        <strong>Smart Config Implementation:</strong> Hệ thống của chúng tôi sử dụng công nghệ "Smart Selection".
      </div>
    </section>

    <section id="auth">
      <h2>🔐 Xác thực (Authentication)</h2>
      <p>
        Mọi request gửi đến API đều cần phải có
        <strong>x-api-key</strong> trong Header.
      </p>
      <pre><code class="language-http">x-api-key: YOUR_API_KEY_HERE</code></pre>
    </section>

    <section id="endpoint">
      <h2>📡 API Endpoint</h2>
      <p>Gửi yêu cầu POST đến địa chỉ sau để nhận Token:</p>

      <div class="api-endpoint mb-4">
        <span class="badge-method me-2">POST</span>
        https://kinxsoftware.online/api/solve
      </div>

      <pre><code class="language-json">{
  "action": "FLOW_GENERATION",
  "proxy": "http://user:pass@ip:port"
}</code></pre>
    </section>

    <section id="proxy">
      <h2>🌐 Cấu hình Proxy</h2>
      <p>Hệ thống hỗ trợ truyền Proxy riêng biệt cho mỗi yêu cầu. Khi được truyền vào, trình duyệt giải captcha sẽ sử
        dụng Proxy này để tránh bị Google chặn IP.</p>

      <div class="card">
        <div class="card-header">Định dạng Proxy hỗ trợ</div>
        <div class="card-body text-light">
          <ul>
            <li><strong>Không xác thực:</strong> <code>http://host:port</code></li>
            <li><strong>Có xác thực:</strong> <code>http://username:password@host:port</code></li>
          </ul>
          <p class="mb-0 text-warning"><i class="bi bi-exclamation-triangle"></i> Lưu ý: Hiện tại hệ thống hỗ trợ tốt
            nhất cho HTTP Proxy.</p>
        </div>
      </div>
    </section>

    <section id="integration">
      <h2>⚙️ Quy trình Tích hợp Chuẩn</h2>
      <p>
        Sau khi nhận được <code>token</code> thành công, hãy thực hiện tích hợp vào Request mục tiêu theo các bước sau:
      </p>

      <h3><span class="step-badge">1</span> Chèn vào Headers</h3>
      <p>Thêm các header sau để xác thực Token với máy chủ mục tiêu:</p>
      <pre><code class="language-http">x-goog-recaptcha-token: [CAPTCHA_TOKEN]
x-recaptcha-token: [CAPTCHA_TOKEN]</code></pre>

      <h3><span class="step-badge">2</span> Chèn vào Body (Context)</h3>
      <p>
        Trong Payload của request chính, hãy đảm bảo cấu trúc <code>clientContext</code> được thiết lập đúng:
      </p>
      <pre><code class="language-json">{
  "clientContext": {
    "recaptchaToken": "[CAPTCHA_TOKEN]",
    "userPaygateTier": "PAYGATE_TIER_TWO",
    "tool": "PINHOLE"
  }
}</code></pre>

      <h3><span class="step-badge">3</span> Đồng bộ User-Agent</h3>
      <p>
        <strong>Quan trọng:</strong> Bạn phải sử dụng đúng User-Agent dưới đây để đảm bảo Token được chấp nhận:
      </p>
      <pre><code class="language-text">Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36</code></pre>
    </section>

    <section id="nodejs">
      <h2>🟩 Code mẫu: Node.js (Built-in)</h2>
      <pre><code class="language-javascript">const http = require('http');
const https = require('https');

/**
 * Script kiểm tra API giải captcha với Proxy
 * Hỗ trợ cả HTTP và HTTPS, tự động chọn module phù hợp
 */
async function testCaptchaWithProxy() {
    const API_URL = 'https://kinxsoftware.online/api/solve';
    const API_KEY = 'YOUR_API_KEY_HERE'; 
    const PROXY = 'http://user:pass@ip:port';

    const postData = JSON.stringify({
        action: 'FLOW_GENERATION',
        proxy: PROXY
    });

    const url = new URL(API_URL);
    const isHttps = url.protocol === 'https:';
    const transport = isHttps ? https : http;

    const options = {
        hostname: url.hostname,
        port: url.port || (isHttps ? 443 : 80),
        path: url.pathname,
        method: 'POST',
        headers: {
            'Content-Type': 'application/json',
            'x-api-key': API_KEY,
            'Content-Length': Buffer.byteLength(postData)
        },
        // Bỏ qua kiểm tra SSL nếu là localhost hoặc server tự cấp chứng chỉ
        rejectUnauthorized: false 
    };

    console.log('--- Đang gửi yêu cầu giải captcha với Proxy ---');
    console.log('URL:', API_URL);
    console.log('Proxy:', PROXY);

    const req = transport.request(options, (res) => {
        let data = '';

        res.on('data', (chunk) => {
            data += chunk;
        });

        res.on('end', () => {
            console.log('Phản hồi từ Server:', res.statusCode);
            try {
                const jsonResponse = JSON.parse(data);
                console.log('Kết quả:', JSON.stringify(jsonResponse, null, 2));
            } catch (e) {
                console.log('Phản hồi không phải JSON:', data);
            }
        });
    });

    req.on('error', (e) => {
        console.error('Lỗi kết nối:', e.message);
    });

    req.write(postData);
    req.end();
}

testCaptchaWithProxy();</code></pre>
    </section>

    <section id="python">
      <h2>🐍 Code mẫu: Python (Requests)</h2>
      <pre><code class="language-python">import requests

def solve_and_run():
    # BƯỚC 1: Lấy Token từ API
    url = "https://kinxsoftware.online/api/solve"
    payload = {
        "action": "FLOW_GENERATION",
        "proxy": "http://user:pass@ip:port" # <-- Thêm proxy tại đây
    }
    headers = {"x-api-key": "YOUR_API_KEY_HERE"}

    res = requests.post(url, json=payload, headers=headers, verify=False)
    data = res.json()
    token = data.get("token")
    
    print(f"Token: {token}")

    # BƯỚC 2: Tích hợp vào request mục tiêu (giữ nguyên User-Agent)
    # ... code tích hợp tiếp theo
</code></pre>
    </section>

    <section id="csharp">
      <h2>🔷 Code mẫu: C# (HttpClient)</h2>
      <pre><code class="language-csharp">using System.Net.Http.Json;

// BƯỚC 1: Lấy Token
var client = new HttpClient();
client.DefaultRequestHeaders.Add("x-api-key", "YOUR_API_KEY_HERE");

var payloadSolver = new { 
    action = "FLOW_GENERATION",
    proxy = "http://user:pass@ip:port" // <-- Thêm proxy tại đây
};

// Gửi yêu cầu giải captcha
var solverRes = await client.PostAsJsonAsync("https://kinxsoftware.online/api/solve", payloadSolver);
var solverData = await solverRes.Content.ReadFromJsonAsync&lt;dynamic&gt;();
string token = solverData.token;

Console.WriteLine($"Token: {token}");
</code></pre>
    </section>

    <footer class="mt-5 text-center text-muted border-top pt-4">
      <p>&copy; 2024 Captcha Solver Professional Service.</p>
    </footer>
  </main>

  <script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/js/bootstrap.bundle.min.js"></script>
  <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0/highlight.min.js"></script>
  <script>
    hljs.highlightAll();
  </script>
</body>

</html>