API 层级结构与端点管理

以层级方式管理自定义端点和 Persisted Query，将相关端点按逻辑结构分组并对外暴露，同时通过分类进行整理。

​

API 层级结构

一个 API 可能会暴露多个相互关联、执行类似 query 的端点。例如，创建以不同语言公开数据的端点时，就会遇到这种情况。

通过 API 层级结构，我们可以为端点定义结构，从而生成如下 URL：

• /graphql/posts/english/
• /graphql/posts/french/

在这种情况下，父级 query posts 提供 GraphQL query，其子级 query english 和 french 则提供用于自定义该 query 的变量。

​

端点管理

创建 Custom Endpoint 或 Persisted Query 时，可以为其添加「GraphQL 端点分类」，以便整理所有端点：

例如，我们可以按客户、应用程序或其他所需信息创建分类来管理端点：

在 Custom Endpoint 和 Persisted Query 的列表中，可以查看各自的分类。点击任意分类链接，或使用顶部的筛选器，即可仅显示该分类下的所有条目：