图像识别高难度验证码接口文档

GET /api/health HTTP/1.1
Host：171.80.1.123:5000

{
    "status"："healthy",
    "timestamp"："2024-01-01T12:00:00.000Z",
    "questions_count"：5,
    "option_letters"：["A", "B", "C", "D"],
    "image_size"：{
        "configured"："600x650",
        "needed"：630,
        "enough"：true
    }
}

GET /api/captcha/generate HTTP/1.1
Host：171.80.1.123:5000

{
    "success"：true,
    "captcha_id"："a1b2c3d4e5f6g7h8",
    "image_base64"："data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAA...",
    "image_size"：{
        "width"：600,
        "height"：650,
        "used_height"：630
    },
    "expire_time"：300,
    "note"："请选择正确的选项字母（A/B/C/D）"
}

POST /api/captcha/verify HTTP/1.1
Host：171.80.1.123:5000
Content-Type：application/json

{
    "captcha_id"："a1b2c3d4e5f6g7h8",
    "answer"："A"
}

{
    "success"：true,
    "verified"：true,
    "token"："eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
    "message"："验证成功"
}

{
    "success"：true,
    "verified"：false,
    "message"："答案错误"
}

{
    "success"：false,
    "error"："验证码已过期或不存在",
    "code"：404
}

{
    "captcha_id"："a1b2c3d4e5f6g7h8",
    "verified"：true,
    "exp"：1704115200
}

// 1. 使旧验证码失效
await fetch('http://171.80.1.123:5000/api/captcha/verify', {
    method：'POST',
    headers：{'Content-Type'：'application/json'},
    body：JSON.stringify({
        captcha_id：old_captcha_id,
        answer：'X'  // 无效答案
    })
});

// 2. 生成新验证码
await fetch('http://171.80.1.123:5000/api/captcha/generate');

const express = require('express');
const axios = require('axios');
const app = express();

const CAPTCHA_SERVER = 'http://171.80.1.123:5000';

// 1. 生成验证码（服务端调用）
app.get('/api/my-captcha/generate', async (req, res) => {
    try {
        // 调用验证码平台
        const response = await axios.get(`${CAPTCHA_SERVER}/api/captcha/generate`);
        
        if (response.data.success) {
            // 保存captcha_id到会话或数据库
            req.session.captcha_id = response.data.captcha_id;
            
            // 只返回图片给客户端，不返回captcha_id
            res.json({
                success：true,
                image_base64：response.data.image_base64,
                expire_time：response.data.expire_time
            });
        } else {
            res.status(500).json({ error：'生成验证码失败' });
        }
    } catch (error) {
        res.status(500).json({ error：'服务异常' });
    }
});

// 2. 验证验证码（服务端转发）
app.post('/api/my-captcha/verify', async (req, res) => {
    try {
        const { answer } = req.body;
        const captcha_id = req.session.captcha_id;
        
        if (!captcha_id || !answer) {
            return res.status(400).json({ error：'参数缺失' });
        }
        
        // 调用验证码平台验证
        const response = await axios.post(`${CAPTCHA_SERVER}/api/captcha/verify`, {
            captcha_id,
            answer
        });
        
        // 清除会话中的验证码信息
        delete req.session.captcha_id;
        
        // 返回验证结果给客户端
        res.json({
            success：response.data.success,
            verified：response.data.verified,
            message：response.data.message
        });
    } catch (error) {
        res.status(500).json({ error：'验证失败' });
    }
});

// 3. 业务接口（受验证码保护）
app.post('/api/submit-form', async (req, res) => {
    try {
        const { formData, captcha_answer } = req.body;
        const captcha_id = req.session.captcha_id;
        
        // 先验证验证码
        const verifyResponse = await axios.post(`${CAPTCHA_SERVER}/api/captcha/verify`, {
            captcha_id,
            answer：captcha_answer
        });
        
        if (!verifyResponse.data.verified) {
            return res.status(403).json({ error：'验证码验证失败' });
        }
        
        // 验证通过，执行业务逻辑
        // ... 处理formData ...
        
        res.json({ success：true, message：'提交成功' });
    } catch (error) {
        res.status(500).json({ error：'处理失败' });
    }
});

<script>
async function generateCaptcha() {
    const response = await fetch('/api/my-captcha/generate');
    const data = await response.json();
    if (data.success) {
        document.getElementById('captchaImage').src = data.image_base64;
        startCountdown(data.expire_time);
    }
}
async function submitForm() {
    const formData = {
    };
    const captchaAnswer = document.querySelector('input[name="captcha"]:checked')?.value;
    
    if (!captchaAnswer) {
        alert('请选择验证码答案');
        return;
    }
    
    const response = await fetch('/api/submit-form', {
        method：'POST',
        headers：{'Content-Type'：'application/json'},
        body：JSON.stringify({
            formData,
            captcha_answer：captchaAnswer
        })
    });
    
    const result = await response.json();
    
    if (result.success) {
        alert('提交成功！');
    } else {
        alert(`提交失败：${result.error}`);
    }
}
</script>

curl http://171.80.1.123:5000/api/health