📝 输入GraphQL Schema或查询
📋 格式化结果
📊 Schema解析
输入Schema后点击"解析Schema"查看类型结构
📖 GraphQL详解
什么是GraphQL
GraphQL是Facebook于2015年开源的API查询语言和运行时。它允许客户端精确指定需要的数据,避免REST API中常见的过度获取和不足获取问题。GraphQL使用强类型系统定义数据结构,支持查询(Query)、变更(Mutation)和订阅(Subscription)三种操作类型。
核心概念
- Schema:类型系统定义,描述API支持的所有数据类型和操作
- Query:只读查询,获取数据
- Mutation:变更操作,修改数据
- Subscription:实时订阅,监听数据变化
- Resolver:解析函数,为每个字段提供数据
- Fragment:可复用的字段集合
使用教程
- 选择模式:Schema(SDL)或查询
- 粘贴GraphQL代码到输入框
- 点击"格式化"美化代码
- 点击"解析Schema"查看类型结构
- 复制结果或下载文件
应用场景
- API开发:设计和验证GraphQL Schema
- 前端对接:构建和格式化查询语句
- 代码审查:格式化后更易发现Schema问题
- 学习研究:理解GraphQL类型系统
📖 常见问题
什么是GraphQL?
GraphQL是Facebook开发的API查询语言,允许客户端精确指定需要的数据,避免过度获取或不足获取。与REST不同,GraphQL使用单一端点,通过类型系统定义数据结构,支持嵌套查询和实时订阅。
GraphQL和REST有什么区别?
主要区别:1)GraphQL单一端点vs REST多端点;2)GraphQL客户端指定数据vs REST服务端固定返回;3)GraphQL强类型系统vs REST无类型约束;4)GraphQL避免过度获取vs REST常返回多余数据;5)GraphQL支持嵌套查询vs REST需多次请求。
什么是GraphQL Schema?
Schema是GraphQL的类型系统定义,描述API支持的所有数据类型、查询和变更操作。它使用Schema Definition Language(SDL)编写,包含Query(查询)、Mutation(变更)和Subscription(订阅)三种根类型。
如何格式化GraphQL查询?
本工具自动将GraphQL查询按照标准格式化:统一缩进2空格、每个字段独占一行、规范花括号位置、整理参数和指令。也可手动调整缩进方式。
数据会上传到服务器吗?
不会。所有GraphQL解析和格式化都在浏览器本地完成,您的Schema和查询不会发送到任何服务器。