API 만들기API 계층 구조 만들기
API 계층 구조 만들기
커스텀 엔드포인트와 퍼시스티드 쿼리는 계층 구조로 정리할 수 있습니다. 이는 부모를 선언함으로써 실현되며, 이 경우 엔드포인트 경로가 부모의 엔드포인트 경로를 확장합니다.
예를 들어, 다음과 같은 계층 구조를 만들 수 있습니다:
- 부모 퍼시스티드 쿼리:
/graphql-query/posts/ - 자식 퍼시스티드 쿼리:
/graphql-query/posts/english/ - 자식 퍼시스티드 쿼리:
/graphql-query/posts/french/
계층의 레벨 수는 무제한이므로, 다음과 같은 구조도 만들 수 있습니다:
/graphql-query/posts//graphql-query/posts/mobile-app//graphql-query/posts/mobile-app/english//graphql-query/posts/mobile-app/french//graphql-query/posts/website//graphql-query/posts/website/english//graphql-query/posts/website/french/
가이드 API 계층 구조 전략을 참고하여 가능한 설정을 확인해 보세요.
속성 상속
자식 커스텀 엔드포인트와 퍼시스티드 쿼리는 부모로부터 속성을 상속받습니다.
커스텀 엔드포인트와 퍼시스티드 쿼리
자식 커스텀 엔드포인트와 퍼시스티드 쿼리는 부모의 스키마 구성을 상속받습니다.
퍼시스티드 쿼리만 해당
자식 퍼시스티드 쿼리는 부모의 GraphQL 쿼리와 변수도 상속받습니다. 변수의 값은 자식이 변수별로 재정의할 수 있습니다.
예를 들어, 부모가 다음 변수를 선언한 경우:
{
"limit": 5,
"offset": 0
}자식이 다음 변수를 선언한 경우:
{
"limit": 10
}자식의 계산된 변수는 다음과 같습니다:
{
"limit": 10,
"offset": 0
}API 계층 구조 만들기
커스텀 엔드포인트 또는 퍼시스티드 쿼리의 문서 설정에는 Page Attributes 섹션이 있으며, 다른 모든 엔티티의 드롭다운에서 부모로 선택할 수 있습니다:
퍼시스티드 쿼리
부모를 선택하면 퍼시스티드 쿼리에 새로운 옵션 「Inherit query from ancestor(s)?」가 표시됩니다.
이 옵션을 Yes로 설정하면, 자식 퍼시스티드 쿼리가 부모의 GraphQL 쿼리를 상속받습니다:
예시
이 퍼시스티드 쿼리는 GraphQL 쿼리를 정의하고, 변수 $limit을 값 1로 선언합니다:
자식 퍼시스티드 쿼리가 이를 확장하여 GraphQL 쿼리를 상속받고, 변수 $limit의 값을 2로 재정의합니다:
Prev
Next