内嵌文档

• 内嵌文档的结构一般都是按照服务端定义的字段结构
  • 每个字段都附有一个文档，没有字段，就没有文档
    • 示例：一个字段对应一个解释
  • 所以不会像笔记一样为了方便理解、归类，而把接口分类
  • 所以嵌入文档都是直接对接实际业务的

使用教程

• 结合文档的IDE，根据文档做语句补全提示，可以一边写调用语句、一边查文档
  https://graphql.org/learn/introspection/
• 并不是真的图形化

实例

github graphAPI

• https://docs.github.com/en/graphql/overview/explorer 左边的文档就是根据所有字段的description字段生成的内嵌文档