# kite-captcha-demo

**Repository Path**: stary1993/kite-captcha-demo

## Basic Information

- **Project Name**: kite-captcha-demo
- **Description**: kite-captcha-demo
- **Primary Language**: JavaScript
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 9
- **Forks**: 2
- **Created**: 2022-12-16
- **Last Updated**: 2025-11-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Kite Captcha Demo

这是一个集成了验证码功能的前后端分离项目，包含简单图像验证码和行为图像验证码两种类型。

## 项目结构

- **kite-captcha-server**: 基于Java的Spring Boot后端，提供验证码生成与校验的REST API。
- **kite-captcha-ui**: 前端UI部分，基于Vue3-ts，用于展示验证码功能。

## 后端功能

- 提供简单图像验证码（Simple Image Captcha）的生成与校验。
- 提供行为图像验证码（Behavior Image Captcha）的生成与校验。
- 支持两种验证码校验方式：
    - 流式校验（Stream-based validation）
    - ID 基础校验（ID-based validation）

## 技术栈

- 后端: Java, Spring Boot
- 前端: Vue3

## 快速开始

### 后端启动

1. 确保你已安装 Java 8 或更高版本。
2. 在 `kite-captcha-server` 目录下运行：
   ```bash
   mvn spring-boot:run
   ```

### 前端启动

1. 确保你已安装 Node.js 和 npm。
2. 进入 `kite-captcha-ui` 目录并运行：
   ```bash
   npm run install
   npm run dev
   ```

## API 接口

### 简单图像验证码

- **生成验证码 (Stream)**: `GET /captcha/simple/gen1?type={type}&timestamp={timestamp}`
- **校验验证码 (Stream)**: `POST /captcha/simple/check1?type={type}&timestamp={timestamp}&code={code}`
- **生成验证码 (ID-based)**: `GET /captcha/simple/gen2?type={type}&timestamp={timestamp}`
- **校验验证码 (ID-based)**: `POST /captcha/simple/check2?id={id}&type={type}&timestamp={timestamp}&code={code}`

### 行为图像验证码

- **生成验证码**: `GET /captcha/behavior/gen?type={type}`
- **校验验证码**: `POST /captcha/behavior/check?id={id}`

## 许可证

该项目使用 MIT 许可证。详情请查看 LICENSE 文件。

## 联系

贾同学<stary1993@qq.com>