GraphQL Playground에서 Cato API에 연결하기

이 글은 GraphQL Playground를 사용하여 샘플 쿼리를 실행하고 Cato Networks API 엔드포인트에 연결성을 테스트하는 방법을 설명합니다.

GraphQL Playground 개요

GraphQL Playground는 Cato API 서버에 직접 전송되는 API 쿼리를 실행할 수 있습니다. Altair 또는 Postman과 같은 타사 API 쿼리 소프트웨어는 API 호출을 실행하기 위한 강력한 기능을 제공합니다. 그러나 API 쿼리에 연결성 문제가 있는 경우 문제의 원인을 식별하는 데 Playground를 사용할 수 있습니다.

필수 조건

GraphQL Playground에서 Cato API 쿼리를 실행하려면 계정의 API 키가 필요합니다 (자원 > API 키). API 키에 대한 자세한 내용은 Cato API의 API 키 생성을 참조하십시오.

샘플 쿼리에서 계정의 Cato 관리 애플리케이션 (CMA) ID를 입력해야 합니다. 계정 정보 페이지에서 CMA ID를 찾을 수 있습니다.

API 엔드포인트의 URL은 Cato 관리 애플리케이션 (CMA) 인스턴스가 호스팅되는 위치에 따라 다릅니다. URL에 추가되는 <prefix> 값이 있을 수 있습니다.

  • 프리픽스 (cc.catonetworks.com)가 없는 경우 다음 URL을 사용하십시오: https://api.catonetworks.com/api/v1/graphql2

  • 프리픽스가 있는 경우 (cc.us1.catonetworks.com 등), 다음 URL을 사용하십시오: https://api.us1.catonetworks.com/api/v1/graphql2

샘플 Cato API 쿼리로 연결성 테스트하기

Cato API 서버에 연결성을 테스트하기 위해 샘플 API 쿼리를 실행할 수 있습니다. accountID 인자와 API 키가 제대로 구성되면, 샘플 API 쿼리는 계정 데이터를 반환하고 결과를 GraphQL Playground에 표시합니다. 쿼리가 계정에 대한 결과를 반환하지 않는 경우, API 서버에 연결성 문제가 있을 수 있거나 서버가 중단되었을 수 있습니다. 다음의 샘플 API 쿼리는 Cato API 서버에 연결성을 테스트하는 데 도움이 될 수 있습니다:

GraphQL Playground에서 샘플 API 쿼리 실행하기

인터넷 브라우저를 사용하여 Cato API의 GraphQL Playground를 엽니다. Playground의 HTTP 헤더를 API 키로 구성합니다. 왼쪽 창에 샘플 쿼리를 붙여넣고 계정 ID를 입력합니다. 그런 다음 쿼리를 실행하고 결과를 Playground에서 볼 수 있습니다.

  1. 이 문서에서 샘플 API 쿼리 중 하나를 다운로드하고 Notepad와 같은 텍스트 편집기에서 파일을 엽니다.

  2. 인터넷 브라우저에서 Cato API의 GraphQL Playground로 이동합니다.

  3. 왼쪽 창 하단에서  HTTP 헤더를 클릭합니다.

  4. API 키를 다음 형식으로 입력하십시오: { "x-api-key" :"<api key>" }.

    다음 스크린샷은 API 키AaBbCcDdEeFf0123456789ABCDEF1234로 구성된 HTTP 헤더를 보여줍니다:

    graphql1.png

  5. 샘플 쿼리 중 하나를 Playground의 왼쪽 창에 복사하고 붙여넣습니다.

  6. 쿼리의 상단에서, accountID 인자에 계정 ID를 입력합니다.

    다음 스크린샷은 값 2626으로 구성된 accountID 인자를 보여줍니다:

    graphql2.png

  7. 재생 버튼을 클릭합니다.

  8. 오른쪽 창에 API 쿼리의 결과가 표시됩니다. 다음 스크린샷은 계정 ID 2626에 대한 샘플 accountMetrics 쿼리의 결과를 보여줍니다:

    graphql3.png

도움이 되었습니까?

1명 중 1명이 도움이 되었다고 했습니다.

댓글 0개