2.0 KiB
2.0 KiB
二维码生成API详情页 Checklist
功能验证
- API详情页可以通过
/api/qrcode-generator访问 - 文档标签页正确显示接口基本信息
- 参数表格包含所有二维码生成参数
- 响应示例显示正确的JSON格式
- 错误码表格包含常见错误码说明
- 测试标签页可以输入参数并发送请求
- 测试结果正确显示状态码、响应时间和响应体
参数文档完整性
- text参数：string类型，必填，描述为"要编码的文本内容"
- errorLevel参数：string类型，可选，默认"M"，描述为"容错率：L(7%)/M(15%)/Q(25%)/H(30%)"
- version参数：integer类型，可选，默认0，描述为"二维码版本1-40，0表示自动"
- margin参数：integer类型，可选，默认2，描述为"边距大小（色块数量），范围1-4"
- size参数：integer类型，可选，默认400，描述为"输出尺寸（像素），范围100-3000"
- fgColor参数：string类型，可选，默认"#000000"，描述为"前景色（十六进制颜色值）"
- bgColor参数：string类型，可选，默认"#ffffff"，描述为"背景色（十六进制颜色值）"
- dotStyle参数：string类型，可选，默认"square"，描述为"点阵样式"
- finderStyle参数：string类型，可选，默认"square"，描述为"定位图案样式"
- logo参数：object类型，可选，描述为"Logo配置，包含image和size"
视觉验证
- Hero区域显示正确的渐变背景
- 标签页切换功能正常
- 代码块显示正确的语法高亮
- 表格样式与其他API详情页一致
- 深色模式下所有元素显示正确
响应式验证
- 桌面端显示正常
- 移动端显示正常
- 表格在小屏幕上可以横向滚动
- 测试表单在小屏幕上布局合理
一致性验证
- 页面结构与天气查询API详情页一致
- 参数表格格式与现有API详情页一致
- 响应示例格式与现有API详情页一致