사용 중인 플랜
모든 Suite Team, Growth, Professional, Enterprise 또는 Enterprise Plus
Support Team, Professional 또는 Enterprise
이 문서에서 설명된 기능은 2026년 5월 11일부터 6월 12일까지 모든 Suite 및 Support 플랜에 배포됩니다. 계정에 아직 이 기능이 표시되지 않을 수도 있습니다. 참조 자세한 내용은 이 공지 사항을 참조하세요.

REST API는 오랫동안 연동 서비스를 위한 표준으로 사용되어 왔지만, GraphQL은 유연성과 효율성으로 인해 빠르게 인기를 얻고 있습니다. 연동 빌더의 기능을 활용하여 GraphQL API와 연동할 수 있습니다. 필요한 데이터만 요청하고 복잡한 쿼리를 쉽게 처리하는 등 GraphQL의 주요 기능을 활용할 수 있습니다.

이 문서에서는 GraphQL 스키마를 이해하는 것부터 쿼리를 구성하고 응답을 대화에 연동하는 것까지 연동 빌더를 사용하여 GraphQL 요청을 설정하는 프로세스를 안내해 드립니다.

GraphQL 요청을 설정하려면 다음과 같이 하세요.

  1. 보통 API 문서에서 제공하는 GraphQL 엔드포인트 URL을 찾습니다(예: https://api.example.com/graphql 또는 Shopify 의 경우 https://).{{storeName}} .myshopify.com/admin/api/2023-04/graphql.json).
  2. 연동 빌더 인터페이스에 추가합니다.
    1. 환경으로 이동하여 POST 방법 유형을 선택합니다(데이터를 요청하는 경우).
    2. URL 입력에 GraphQL 엔드포인트를 추가합니다.
  3. 인증 방법을 선택합니다(필요한 경우).
  4. 필요한 경우 헤더에 자격 증명을 추가합니다. 예를 들어 Shopify 연동 서비스인 경우에는 다음과 같이 표시됩니다.
  5. GraphQL 스키마를 이해하여 서버에서 리턴하려는 데이터를 선택합니다.
  6. GraphQL 서버에서 스키마를 가져옵니다.

    사용 가능한 쿼리, 변형 및 유형을 정의합니다. Postman, GraphiQL 또는 Apollo Explorer와 같은 도구를 사용하여 스키마를 검사하고 쿼리를 테스트 및 세분화합니다.

    코드 스니펫 탭으로 이동하여 “query” 키가 있는 개체가 표시되어야 하는 데이터를 확인하여 Postman에서 쿼리를 가져오는 것이 좋습니다. 다음 단계에서 사용할 개체를 복사합니다.
  7. 본문 탭에서 필요한 데이터나 수행하려는 작업(데이터를 수정하기 위해 변형 요청을 하는 경우 만들기, 업데이트, 삭제)을 지정하는 GraphQL 쿼리를 추가합니다.
    JSON 형식이어야 합니다.
    쿼리 예:
    ```{"query":"{\n __type(name: \"Order\") {\n 이름,\n fields {\n 이름\n { 입력\n 이름\n 종류\n }\n }\n }\n}","variables":{}}```
  8. 성공 시나리오로 이동하여 세션 매개변수를 추가합니다.
  9. JSONata를 사용하여 응답의 데이터에 액세스하고 필요한 경우 변환하는 쿼리를 작성합니다. 예는 아래를 참조하세요.

 

번역 고지 사항: 본 문서는 콘텐츠에 대한 기본적인 이해를 제공하기 위해 자동 번역 소프트웨어를 사용하여 번역되었습니다. 정확한 번역을 제공하고자 합당한 노력을 기울였으나 Zendesk는 번역의 정확성을 보장하지 않습니다.

번역된 문서에 포함된 정보의 정확성과 관련하여 질문이 있으시면 문서의 공식 버전인 영문 버전을 참조하시기 바랍니다.

Zendesk 제공