UD5工具箱
Q：什么是JSON Schema？为什么需要它？
A：JSON Schema是一种用于描述JSON数据结构的规范语言。它定义了数据的字段类型、是否必填、取值范围等约束条件。在API开发中，使用JSON Schema可以自动验证请求和响应数据的完整性，减少接口联调中的错误，提高开发效率。结合Swagger/OpenAPI等工具，还可以自动生成API文档。它的核心价值在于让数据验证标准化、自动化，减少人工检查的工作量。
Q：工具如何推断字段的类型？推断结果一定准确吗？
A：工具根据JSON示例数据中每个字段的实际值来推断其类型。例如，值「Hello」被推断为string类型，值42被推断为integer类型，值true被推断为boolean类型。推断结果取决于示例数据的覆盖范围。如果示例数据中某个字段的值始终是字符串类型，但实际使用中它也可能是数字，那么生成的Schema可能不够全面。建议提供尽可能多样的示例数据以提高推断准确度，同时建议在生成后根据实际业务需求进行人工复核。
Q：required和additionalProperties在Schema中有什么作用？
A：required用于指定对象中必须包含哪些字段，缺少必填字段时验证会失败。additionalProperties控制是否允许出现未定义的额外字段，设为false时会严格限制字段集合。本工具在生成Schema时，会将示例数据中存在的字段自动加入required数组，并将additionalProperties设置为false，以生成更严格的验证规则。您可以根据实际需求自行调整这些设置，例如在扩展性要求较高的API中将additionalProperties设为true。
Q：Draft-07和2020-12版本有什么区别？应该选择哪个？
A：Draft-07是2018年发布的版本，被绝大多数验证工具广泛支持，兼容性最好。2020-12是最新稳定版，引入了prefixItems、$defs等新特性，但部分验证器尚未完全支持。如果您使用AJV 6.x、jsonschema Python库等旧版验证器，建议选择Draft-07。如果您的验证工具已经升级支持2020-12版本，且需要使用最新特性，则可以选择2020-12。本工具同时支持两种版本，您可以随时切换对比生成结果。
Q：生成后的Schema如何验证我的数据？
A：生成Schema后，您可以使用多种方式验证数据。在前端，可以使用AJV（JavaScript）、tv4等库进行验证。在后端，Python有jsonschema库，Java有everit-json-schema库，Go有gojsonschema库。也可以使用在线JSON Schema验证工具，将Schema和数据分别粘贴即可检查。本工具生成的Schema遵守标准规范，兼容主流的验证库，可以直接集成到您的项目中。
Q：工具的推断逻辑有哪些局限？
A：工具的推断逻辑存在几点局限：一是只基于您提供的示例数据，无法覆盖所有可能的数据形态；二是对于枚举值无法自动识别为enum，会推断为普通类型；三是对复杂条件验证（如if/then/else）无法自动生成；四是对于字符串格式如email、date、uri等不会自动标注format关键字。建议将生成结果作为基础模板，在此基础上按需补充更精确的验证规则，例如手动添加枚举值、格式约束和条件验证逻辑。
Q：我的数据安全吗？会上传到服务器吗？
A：您的数据完全安全。本工具采用纯前端架构，所有JSON数据的解析、分析和Schema生成过程均在您的浏览器本地完成。您的数据不会被上传到任何服务器，也不会被存储或记录。您可以放心地在工具中处理包含敏感信息的API数据结构，包括密钥信息、用户数据等。关闭页面后所有临时数据都会被自动清除。