API 계층 구조 및 엔드포인트 관리

커스텀 엔드포인트와 Persisted Query를 계층적으로 관리하여, 관련 엔드포인트를 논리적인 구조로 그룹화하고 노출하며, 카테고리를 통해 정리합니다.

​

API 계층 구조

API는 서로 관련된 여러 엔드포인트를 노출할 수 있으며, 이러한 엔드포인트들은 유사한 쿼리를 실행하는 경우가 많습니다. 예를 들어, 데이터를 서로 다른 언어로 노출하는 엔드포인트를 생성할 때가 이에 해당합니다.

API 계층 구조를 통해 엔드포인트에 구조를 정의하여 다음과 같은 URL을 생성할 수 있습니다:

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

이 경우, 부모 쿼리 posts가 GraphQL 쿼리를 제공하고, 자식 쿼리 english와 french가 쿼리를 커스터마이즈하는 변수를 제공합니다.

​

엔드포인트 관리

Custom Endpoint 또는 Persisted Query를 생성할 때 "GraphQL 엔드포인트 카테고리"를 추가하여 모든 엔드포인트를 정리할 수 있습니다:

예를 들어, 클라이언트별, 애플리케이션별, 또는 기타 필요한 정보별로 엔드포인트를 관리하는 카테고리를 생성할 수 있습니다:

Custom Endpoint 및 Persisted Query 목록에서 각 카테고리를 확인할 수 있으며, 카테고리 링크를 클릭하거나 상단의 필터를 사용하면 해당 카테고리에 속한 항목만 표시됩니다: