API CaptchaAI JSON và API biểu mẫu: Nên sử dụng định dạng nào

CaptchaAI chấp nhận các yêu cầu ở cả định dạng được mã hóa biểu mẫu và JSON. Cả hai đều hoạt động giống nhau — hãy chọn dựa trên ngôn ngữ và sở thích của bạn.

So sánh song song

Mã hóa biểu mẫu (Mặc định)

import requests

resp = requests.post("https://ocr.captchaai.com/in.php", data={
    "key": "YOUR_API_KEY",
    "method": "userrecaptcha",
    "googlekey": "SITE_KEY",
    "pageurl": "https://example.com",
    "json": 1,
})

Loại nội dung: application/x-www-form-urlencoded

JSON

import requests

resp = requests.post("https://ocr.captchaai.com/in.php", json={
    "key": "YOUR_API_KEY",
    "method": "userrecaptcha",
    "googlekey": "SITE_KEY",
    "pageurl": "https://example.com",
    "json": 1,
})

Loại nội dung: application/json

Sự khác biệt chính

Định dạng phản hồi

Thêm json=1 để nhận phản hồi JSON bất kể định dạng yêu cầu:

# Without json=1 — plain text response
resp = requests.post("https://ocr.captchaai.com/in.php", data={
    "key": "YOUR_API_KEY",
    "method": "userrecaptcha",
    "googlekey": "SITE_KEY",
    "pageurl": "https://example.com",
})
# Response: "OK|12345678"

# With json=1 — JSON response
resp = requests.post("https://ocr.captchaai.com/in.php", data={
    "key": "YOUR_API_KEY",
    "method": "userrecaptcha",
    "googlekey": "SITE_KEY",
    "pageurl": "https://example.com",
    "json": 1,
})
# Response: {"status": 1, "request": "12345678"}

Luôn sử dụng json=1 để phân tích cú pháp dễ dàng hơn.

Ví dụ về Python

Được mã hóa biểu mẫu

import requests

# Submit
resp = requests.post("https://ocr.captchaai.com/in.php", data={
    "key": "YOUR_API_KEY",
    "method": "userrecaptcha",
    "googlekey": "SITE_KEY",
    "pageurl": "https://example.com",
    "json": 1,
})
task_id = resp.json()["request"]

# Poll (always GET with query params)
resp = requests.get("https://ocr.captchaai.com/res.php", params={
    "key": "YOUR_API_KEY",
    "action": "get",
    "id": task_id,
    "json": 1,
})

Nội dung JSON

import requests

# Submit with JSON
resp = requests.post("https://ocr.captchaai.com/in.php", json={
    "key": "YOUR_API_KEY",
    "method": "userrecaptcha",
    "googlekey": "SITE_KEY",
    "pageurl": "https://example.com",
    "json": 1,
})
task_id = resp.json()["request"]

# Poll (same as form-encoded — GET with params)
resp = requests.get("https://ocr.captchaai.com/res.php", params={
    "key": "YOUR_API_KEY",
    "action": "get",
    "id": task_id,
    "json": 1,
})

Ví dụ về Node.js

Được mã hóa biểu mẫu

const axios = require('axios');
const qs = require('querystring');

// Submit
const resp = await axios.post(
  'https://ocr.captchaai.com/in.php',
  qs.stringify({
    key: 'YOUR_API_KEY',
    method: 'userrecaptcha',
    googlekey: 'SITE_KEY',
    pageurl: 'https://example.com',
    json: 1,
  })
);
const taskId = resp.data.request;

Nội dung JSON

const axios = require('axios');

// Submit with JSON
const resp = await axios.post(
  'https://ocr.captchaai.com/in.php',
  {
    key: 'YOUR_API_KEY',
    method: 'userrecaptcha',
    googlekey: 'SITE_KEY',
    pageurl: 'https://example.com',
    json: 1,
  }
);
const taskId = resp.data.request;

CAPTCHA hình ảnh: Biểu mẫu so với JSON

Đối với CAPTCHA hình ảnh, định dạng quan trọng hơn:

Biểu mẫu có tệp tải lên (Nhiều phần)

# File upload — form-encoded with multipart
resp = requests.post("https://ocr.captchaai.com/in.php",
    data={
        "key": "YOUR_API_KEY",
        "method": "post",
        "json": 1,
    },
    files={
        "file": open("captcha.png", "rb"),
    },
)

JSON với Base64

import base64

# Base64 in JSON body
with open("captcha.png", "rb") as f:
    body = base64.b64encode(f.read()).decode()

resp = requests.post("https://ocr.captchaai.com/in.php", json={
    "key": "YOUR_API_KEY",
    "method": "base64",
    "body": body,
    "json": 1,
})

Biểu mẫu với Base64

# Base64 in form data
resp = requests.post("https://ocr.captchaai.com/in.php", data={
    "key": "YOUR_API_KEY",
    "method": "base64",
    "body": body,
    "json": 1,
})

Khi nào nên sử dụng cái nào

Những lỗi thường gặp

Câu hỏi thường gặp

Định dạng có ảnh hưởng đến tốc độ hoặc độ chính xác của việc giải quyết không?

Không. Cả hai định dạng đều tạo ra kết quả giống nhau. Máy chủ xử lý chúng theo cùng một cách.

Tôi có thể trộn các định dạng trong cùng một dự án không?

Vâng. Bạn có thể gửi bằng JSON và thăm dò ý kiến ​​​​với các thông số truy vấn (đó là cách hoạt động của cuộc thăm dò ý kiến). Mỗi yêu cầu là độc lập.

API tương thích với 2Captcha sử dụng định dạng nào?

API 2Captcha ban đầu sử dụng mã hóa biểu mẫu. CaptchaAI bổ sung thêm tính năng hỗ trợ JSON. Nếu bạn đang di chuyển từ 2Captcha, hãy sử dụng mã hóa biểu mẫu.

Hướng dẫn liên quan

• Cây quyết định xử lý lỗi API
• Thẻ tham khảo nhanh API

Chọn định dạng ưa thích của bạn —thử API CaptchaAIHôm nay.