| <!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<dynamic>();
|
| string token = solverData.token;
|
|
|
| Console.WriteLine($"Token: {token}");
|
| </code></pre>
|
| </section>
|
|
|
| <footer class="mt-5 text-center text-muted border-top pt-4">
|
| <p>© 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> |
