← 返回
未分类

API测试自动化专家版

API接口测试全能自动化专家。支持REST/GraphQL功能测试、Spring Doc/OpenAPI解析、 YAML测试定义、性能测试、契约测试、测试点分析、180陷阱知识库。 TRIGGER: 测试API/接口测试/测登录/测注册/测CRUD/测试设计/陷阱检查/性能测试/契约测试
API接口测试全能自动化专家。支持REST/GraphQL功能测试、Spring Doc/OpenAPI解析、 YAML测试定义、性能测试、契约测试、测试点分析、180陷阱知识库。 TRIGGER: 测试API/接口测试/测登录/测注册/测CRUD/测试设计/陷阱检查/性能测试/契约测试
star.qin
未分类 community v1.0.0 1 版本 100000 Key: 无需
★ 0
Stars
📥 95
下载
💾 0
安装
1
版本
#latest

概述

API Test Automation v1.5.0

API接口测试全能自动化专家。渐进式路由,按需加载模块。


精练路由表

> 匹配规则:关键词命中 → 加载脚本 → 执行。多关键词加载全部对应模块。

关键词脚本模块核心功能
---------------------------
测登录 测注册 测CRUD 测分页SmartTestParser自然语言→测试用例,9快捷指令
测试设计 测试点 测试分析TestAnalyzer智能测试点分析,生成文档
陷阱 易错 检查清单PitfallChecker + SecurityChecker180+陷阱,9类安全检查
诊断 429 500 重试DiagnosticAnalyzer四层诊断+智能重试
REST HTTP GET POSTRestClientREST API 测试客户端
GraphQL query mutationGraphQLClientGraphQL 测试支持
YAML 无代码 批量YAMLRunner + TemplateLoader285场景模板,变量传递
Spring Doc OpenAPI SwaggerSpringDocParserOpenAPI 自动解析
性能 负载 并发PerformanceTester性能/压力测试
契约 Schema 验证ContractTesterOpenAPI/JSON Schema 验证
Mock 模拟 MockServer快速 Mock 服务
报告 HTML AllureTestReporter多格式报告生成
环境 配置EnvManager多环境管理

完整映射 → references/route_table_full.md


检查点(Inversion 门控)

Phase门控问题确认条件
---------------------------
设计阶段"测试范围是[X],是否继续?"用户确认=Y → 执行
执行阶段"失败≥[阈值]次,是否中止?"失败计数≥阈值 → 暂停等待确认
报告阶段"生成[格式]报告,路径[output]?"用户确认输出路径

门控示例

设计阶段:
  检测到关键词:测登录
  → 加载 SmartTestParser + TemplateLoader
  → 分析范围:auth_login.yaml (28场景)
  → 门控:"测试登录接口28个场景,是否继续?" [Y/n]
  
执行阶段:
  执行中:12 passed, 3 failed
  → 阈值触发:failed >= 3
  → 门控:"已失败3次,是否中止并诊断?" [Y/n]

边界条件与 Fallback

异常处理策略

异常类型Fallback 路径恢复策略
-----------------------------------
网络超时重试3次 + 递增延迟(2s→4s→6s)DiagnosticAnalyzer.retry_on_timeout()
429限流解析 Retry-After + 等待重试DiagnosticAnalyzer.smart_retry_on_429()
500服务端重试3次 + 日志记录DiagnosticAnalyzer.retry_on_server_error()
认证失败Token刷新 + 重新请求RestClient.refresh_auth()
资源不存在日志 + 跳过测试标记 skipped,继续后续
模板加载失败使用默认模板TemplateLoader.load_template() → fallback=True
JSON解析失败返回原始响应response.text fallback
配置缺失使用默认配置EnvManager.get_env() → default_value

错误恢复示例

# 429限流智能处理
response = client.get("/api/data")
if response.status_code == 429:
    result = analyzer.smart_retry_on_429(response)
    if result.success:
        print(f"等待{result.wait_seconds}秒后重试成功")
    else:
        print("重试失败,跳过此测试")
        # Fallback: 跳过并记录

脚本调用精练版

# 最简测试
from scripts import RestClient, Assertions
client = RestClient(base_url="http://localhost:8080")
response = client.get("/api/users")
Assertions.assert_status_code(response, 200)

# 智能解析(一句话生成测试)
from scripts.smart_test_parser import SmartTestParser
parser = SmartTestParser(base_url="http://localhost:8080")
results = parser.parse_and_run("测登录")

# 测试点分析
from scripts import TestAnalyzer
analyzer = TestAnalyzer.from_openapi("openapi.yaml")
analysis = analyzer.analyze_endpoint("/api/users", "POST")

# YAML批量测试
from scripts import YAMLRunner
runner = YAMLRunner(base_url="http://localhost:8080")
results = runner.run("test-suite.yaml")

完整示例 → references/quick_start.md


约束(精练版)

  1. 设计优先:新接口先生成测试分析文档
  2. 响应断言:先检查 status_code,再检查业务码
  3. 变量提取:统一 JSONPath 格式
  4. 性能渐进:负载测试渐进式加压
  5. 批量报告:批量测试后必须生成报告
  6. 门控确认:失败阈值触发时暂停等待用户确认

v1.5.0 变更

  • 精练路由表:压缩至核心映射,完整版移至 references
  • 检查点门控:设计阶段/执行阶段/报告阶段三重门控
  • 边界补充:8类异常Fallback路径 + 恢复策略
  • Token优化:SKILL.md 精练至150行(原198行)
  • 版本管理:变更详情移至 CHANGELOG.md

完整变更历史 → CHANGELOG.md


依赖

Python 3.8+ | requests 2.28+ | httpx 0.24+ | pytest 7.0+

版本历史

共 1 个版本

  • v1.0.0 # API Test Automation - 版本变更日志 ## v1.4.0 (2026-05-10) ### 核心变更 - **共享工具函数**:`navigate_json_path` 统一JSON路径解析,消除重复代码 - **安全增强**:SSL验证警告、敏感请求头日志脱敏 - **缓存管理**:`CacheManager.reset_instance()` 支持测试隔离 - **异步优化**:性能测试批量任务执行,避免内存爆炸 - **条件表达式**:YAML `when` 支持 `>=` `<=` `in` `not in` `is empty` 等操作符 - **代码质量**:全模块裸except替换为具体异常类型 ### 详细改进 | 模块 | 改进项 | 影响 | |------|--------|------| | utils.py | 新增 navigate_json_path | 消除5处重复代码 | | rest_client.py | SSL验证警告日志 | 安全合规 | | cache_manager.py | reset_instance() | 测试隔离支持 | | performance.py | 批量任务内存优化 | 避免 OOM | | yaml_runner.py | 条件表达式扩展 | 更灵活的跳过逻辑 | --- ## v1.3.0 (2026-05-08) - 智能缓存策略:惰性加载 + TTL过期 - 渐进式披露:按需加载 references 文档 - 动态分析:实时生成测试建议 --- ## v1.2.0 (2026-05-04) - 合并 apitestcreate 技能 - 新增 140 陷阱知识库 - 测试设计能力增强 --- ## v1.1.0 (2026-05-01) - 重构为渐进式路由引导 - 新增 GraphQL 测试支持 - 新增契约测试模块 --- ## v1.0.0 (2026-04-01) - 初始版本 - REST API 测试核心功能 - YAML 测试定义 - Spring Doc 自动解析 当前
    2026-05-16 14:34 安全 安全

安全检测

腾讯云安全 (Keen)

安全,无风险
查看报告

腾讯云安全 (Sanbu)

安全,无风险
查看报告

🔗 相关推荐

大模型中文最强搜索引擎150+

user_b91ca78d
★ 1 📥 155

MyBatis-Flex Agent快速开发技能

user_b91ca78d
MyBatis-Flex框架开发专家技能。提供完整的MyBatis-Flex使用指导,包括Entity定义、QueryWrapper查询构建、BaseMapper操作、多数据源配置、多租户、逻辑删除、乐观锁、代码生成器等。
★ 0 📥 121

Agent Skills技能演化专家版本(也许是地表最强)

user_b91ca78d
技能优化专家 - 渐进式路由驱动的智能技能优化器。 触发场景:优化/改进/重构/审核/诊断/调优/标准化/升级 skill 或 SKILL.md 核心能力:三级路由 + 8维度评估 + 21项诊断检查 + 四类验证测试 + 5大设计模式 +
★ 0 📥 84