Gato GraphQL vs WP REST API

REST API와 GraphQL API의 차이점은 WP REST API와 Gato GraphQL을 비교할 때도 일반적으로 적용됩니다.

GraphQL을 사용하면 엔드포인트에 대해 맞춤형 GraphQL 쿼리를 실행하여, 필요한 특정 데이터를 지정하고 단일 요청으로 해당 데이터만 가져올 수 있습니다.

예를 들어, 아래 GraphQL 쿼리는 특정 게시물에 필요한 데이터를 관계 데이터(작성자, 카테고리, 태그)를 포함하여 단일 요청으로 가져옵니다.

query {
  post(by: { id: 1 }) {
    title
    content
    url
    date
    author {
      id
      name
    }
    categories {
      id
      name
    }
    tags {
      id
      name
    }
  }
}Copy

REST로 동일한 데이터를 가져오려면 먼저 게시물 데이터를 가져오는 요청을 실행하고, 이후 각 관계(작성자, 카테고리, 태그)의 데이터를 가져오기 위한 추가 요청이 필요할 수 있습니다.

REST와 GraphQL 간의 이러한 아키텍처적 차이점은 다른 곳에서 광범위하게 다루어졌으므로, 여기서는 반복하지 않겠습니다.

아래에서는 Gato GraphQL(모든 확장 기능 포함)과 WP REST API를 더 구체적으로 비교해 보겠습니다.

​

요약 표

주요 포인트 요약:

• 데이터 가져오기: Gato GraphQL은 맞춤형 쿼리를 사용하고, WP REST API는 여러 엔드포인트 요청을 사용합니다.
• 엔드포인트: Gato GraphQL은 UI로 생성된 Persisted Queries를 사용하고, WP REST API는 PHP로 작성된 REST 엔드포인트를 사용합니다.
• 접근 제어: Gato GraphQL은 필드 수준의 제어를 제공하고, WP REST API는 context 파라미터를 사용합니다.
• 일괄 작업: Gato GraphQL은 Multiple Query Execution을 사용하고, WP REST API는 배치 요청을 사용합니다.
• 사이트 관리: Gato GraphQL은 종합적인 도구이고, WP REST API는 주로 API입니다.

​

사전 정의 데이터 접근

WP REST API에서는 REST 엔드포인트를 통해 데이터를 공개합니다. 각 엔드포인트는 고유한 URL을 가지며, 해당 데이터는 (게시물이나 사용자 등 대응하는 리소스에 대해) 사전에 정의되어 있습니다.

REST 엔드포인트와 유사하게, Gato GraphQL은 Persisted Queries를 지원하며, 이것도 사전 정의 데이터를 가진 엔드포인트입니다. GET으로 Persisted Query를 요청하면 저장된 GraphQL 쿼리가 실행되어 예상되는 JSON 응답이 생성됩니다.

양자의 차이점은, REST API 엔드포인트는 PHP 코드로 생성되어 테마나 플러그인 내에 배포되어야 하는 반면, Gato GraphQL의 Persisted Queries는 GraphQL 언어를 사용하여 작성되고 코드 배포 없이 wp-admin 내 사용자 인터페이스(WordPress 편집기 기반)를 통해 게시된다는 점입니다.

REST 엔드포인트와 GraphQL Persisted Queries 모두에 동일한 캐싱 메커니즘을 적용할 수 있습니다. Persisted Query는 자체 엔드포인트를 통해 접근되므로, 그 응답은 표준 HTTP 캐싱으로 캐시될 수 있습니다(PRO).

​

접근 제어

WP REST API에서 데이터 제한은 context 파라미터에 의존합니다. ?context=view를 전달하면 비인증 사용자를 위한 데이터가 반환되고, ?context=edit는 (적절한 권한을 가진) 인증된 사용자에게 게시물의 content.raw 필드 등의 추가 데이터를 포함합니다.

Gato GraphQL은 훨씬 높은 유연성을 제공하며, 접근 제어 규칙에 따라 모든 단일 필드에 대해 접근 가능 여부를 설정할 수 있습니다. 로그인한 사용자만, 특정 역할이나 권한을 가진 사용자만, 또는 특정 IP 범위의 방문자만 특정 필드에 접근할 수 있도록 검증할 수 있습니다(PRO).

​

일괄 작업

WP REST API는 배치 요청을 실행할 수 있으며, 여러 요청이 단일 HTTP 요청 내에서 내부적으로 처리됩니다.

Gato GraphQL은 Multiple Query Execution을 제공하며, 단일 GraphQL 문서에서 여러 작업을 실행할 수 있습니다.

Multiple Query Execution은 배치 요청의 개선판으로, @export 디렉티브를 통해 작업 간에 상태를 공유할 수 있습니다.

예를 들어, 게시물을 복제하려면 query 작업으로 게시물 데이터를 가져오고, 해당 데이터를 mutation 작업에 전달하여 새 게시물을 생성합니다.

query GetPostAndExportData($postId: ID!)
{
  post(by: { id: $postId }, status: any) {
    author {
      id @export(as: "authorID")
    }
    categories {
      id @export(as: "categoryIDs", type: LIST)
    }
    rawContent @export(as: "rawContent")
    rawExcerpt @export(as: "excerpt")
    featuredImage {
      id @export(as: "featuredImageID")
    }
    tags {
      id @export(as: "tagIDs", type: LIST)
    }
    rawTitle @export(as: "title")
  }
}
 
mutation DuplicatePost
  @depends(on: "GetPostAndExportData")
{
  createPost(input: {
    status: draft,
    authorBy: {
      id: $authorID
    },
    categoriesBy: {
      ids: $categoryIDs
    },
    contentAs: {
      html: $rawContent
    },
    excerpt: $excerpt
    featuredImageBy: {
      id: $featuredImageID
    },
    tagsBy: {
      ids: $tagIDs
    },
    title: $title
  }) {
    postID
  }
}Copy

​

WordPress 사이트 관리

Gato GraphQL을 사용하면 데이터베이스에서 데이터를 가져오고, 필요에 따라 수정하고, 모두 단일 GraphQL 문서 내에서 다시 저장할 수 있습니다.

이는 사용자 인터페이스를 통해 실현되며, GraphQL 쿼리를 작성하고 게시하고, 필요에 따라 엔드포인트를 설정하고, 어떤 이벤트가 발생했을 때 쿼리 실행을 자동화할 수 있습니다.

이 모든 것이 의미하는 바는, Gato GraphQL이 WordPress 사이트를 관리하기 위한 범용 도구로서, 데이터(WordPress 사이트의 것이든 서드파티 서비스에서 제공되는 것이든)를 뮤테이션해야 하는 사용 사례를 GraphQL 쿼리 실행을 통해 처리할 수 있다는 것입니다.

Gato GraphQL이 얼마나 많은 플러그인의 기능을 제공할 수 있는지 살펴보세요.

• 복제 플러그인이 아니지만, 게시물을 복제할 수 있습니다.
• 자동화 플러그인이 아니지만, 아무런 제약 없이 작업을 자동화할 수 있습니다.
• 백업 플러그인이 아니지만, 게시물을 가져오기하거나 다른 WP 사이트로 내보내기할 수 있습니다.
• 검색 및 치환 플러그인이 아니지만, 모든 게시물을 일괄 수정할 수 있습니다.
• 웹훅 플러그인이나 HTTP 클라이언트가 아니지만, 임의의 API에 요청을 보내거나 임의의 서비스로부터 수신 요청을 받아 처리할 수 있습니다.
• 번역 플러그인이 아니지만, 모든 콘텐츠를 번역할 수 있습니다.

WP REST API는 말 그대로 API입니다.

Gato GraphQL도 API이지만, 그 이상의 존재입니다.