Spaces:

vipsphi
/

luadao

Sleeping

File size: 11,990 Bytes

c135c3c

<!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>