kcaptcha 1.0.3

Kcaptcha API文档

最新版本：1.0.3

pip install kcaptcha==1.0.3

更新

2022-04-18:

1. 打包时未能正确包含数据文件的问题修复。

2022-04-17：

1. 已通过pypi发布。可通过pip install kcaptcha安装。（但不想写文档先忍一下[doge]）

   from kcaptcha.core import SlideKiller
   
   
   slide_killer = SlideKiller()
   # test slide match mode
   with open('imgs/slide_match_target_1.jpg', 'rb') as f:
       test_match_target = f.read()
   with open('imgs/slide_match_bg_1.jpg', 'rb') as f:
       test_match_background = f.read()
   match_result = slide_killer.match(test_match_target, test_match_background, simple_target=True,
                                     target_threshold=(200, 300),
                                     method=4,
                                     background_threshold=(100, 200), debug=True, border=True)
   

2. 增加调试参数，显示参数，识别过程中各阶段的图像，方便调整。

一、概述

通过API提供类型识别、识别码的识别码的识别点的识别服务。

主机： 192.168.0.155:9898

可以处理的验证码示例如下：

1. 通用字符型鉴定

   

2. 通用点选（不带语序，仅用于目标识别）

   

3. 通用通用匹配模式

   于能获取图片（及目标图片）的背景图（背景图）

   

4. 通用通用-比较模式

   及带获取背景图的背景图验证于身份，从而能够返回完整距离

5. 极验文字点选验证码

   按顺序点选文字验证码，图标形式暂未实现。

二、通用字符型验证码

1. 请求参数（POST）

2. 返回数据

3. 请求示例

import requests

url = HOST + '/common/ocr/file'
img_file_path = {Your Img Filepath}
files = {
    'img': ('img', open(img_file_path, 'rb'))
}
response = requests.post(url, files=files)

4. 响应示例

{"code": 200, "results": "jepv", "msg": ""}

三、通用点选型验证码

1. 请求参数（POST）

2. 返回数据

3. 请求示例

import requests

url = HOST + '/common/det/file'
img_file_path = {Your Img Filepath}
files = {
    'img': ('img', open(img_file_path, 'rb'))
}
response = requests.post(url, files=files)

4. 响应示例

{"code": 200, "results": [[131, 53, 182, 103], [214, 52, 258, 96], [299, 105, 350, 154], [292, 17, 341, 65]], "msg": ""}

四、通用识别码识别-匹配模式

1. 请求参数（POST）

注：因各种时发现验证码存在差异，当识别准确率不高，可尝试调整方法、阈值_阈值_最小值、目标阈值_最大值、背景阈值_最大值、目标阈值_参数、边界参数

2. 返回数据

3. 请求示例

import requests

url = HOST + '/common/slide-match/file'
target_img_file_path = {Your Img Filepath}
bg_img_file_path = {Your Img Filepath}
data = {
    'method': 4,
    'target_threshold_min': 100,
    'target_threshold_max': 300,
    'background_threshold_min': 100,
    'background_threshold_max': 130,
    'border': True
}
files = {
    'target_img': ('img', open(target_img_file_path, 'rb')),
    'bg_img': ('img', open(bg_img_file_path, 'rb')),
}
response = requests.post(url, files=files, data=data)

4. 响应示例

{"code": 200, "results": {"target_y": 0, "target": [191, 116, 259, 184]}, "msg": ""}

五、通用识别码识别-对比模式

1. 请求参数（POST）

2. 返回数据

3. 请求示例

import requests

url = HOST + '/common/slide-compare/file'
full_bg_img_path = {Your Img Filepath}
bg_img_path = {Your Img Filepath}
files = {
    'full_bg_img': ('img', open(full_bg_img, 'rb')),
    'bg_img': ('img', open(bg_img_path, 'rb')),
}
response = requests.post(url, files=files)

4. 响应示例

{"code": 200, "results": {'target': [124, 79]}, "msg": ""}

六、极验文字点选验证码识别

1. 请求参数（POST）

2. 返回数据

3. 请求示例

import requests

url = HOST + '/geetest/order-click/file'
img_file_path = {Your Img Filepath}
files = {
    'img': ('img', open(img_file_path, 'rb'))
}
response = requests.post(url, files=files)

4. 响应示例

{"code": 200, "results": [{"char": "松", "target": [149, 125, 207, 182]}, {"char": "油", "target": [9, 242, 67, 300]}, {"char": "醇", "target": [94, 25, 156, 87]}], "msg": ""}

去做：

• 通过pypi发布，以提供更多的方式使用

• 增加的调试功能：调用时任选可以返回中间的过程图，方便调节值等参数提高准确率

• 极验图标点选验证

• 极验语序点选验证码

• 计算式验证码处理