그래프QL 사용
3

GraphQL은 쿼리의 데이터 구조를 정의하고 원하는 것과 더 이상 아무것도 요청할 수 있는 최신 쿼리 언어입니다.

GraphQL 쿼리는 한 리소스의 속성뿐만 아니라 리소스 간의 참조를 원활하게 따르도록 액세스합니다. 일반적인 REST API는 여러 URL에서 로드해야 하지만 GraphQL API는 앱이 단일 요청에서 필요한 모든 데이터를 가져옵니다.

작업

쿼리: 읽기 작업은 GraphQL 쿼리에 의해 수행되며 이러한 작업은 데이터를 변경하지 않습니다.

돌연변이: 돌연변이를 사용하여 다른 모든 작업을 수행하여 데이터를 수정합니다.

개체 유형

개체 유형은 API에서 쿼리할 수 있는 데이터 집합을 정의하는 데 사용되는 필드 집합입니다.

그래프QL
query {
}

mutation {
}

필드

필드는 특정 개체 속성을 요청하는 데 사용됩니다.

각 개체에는 필요한 속성을 쿼리하기 위해 이름으로 쿼리할 수 있는 필드가 있습니다.

그래프QL
query {
  EnjinToken {
     id
  }
}

인수

인수를 전달하여 쿼리의 반환 값을 결정할 수 있습니다. 이렇게 하면 결과가 좁아지고 후에 필요한 것만 얻을 수 있습니다.

다음 예제에서 개체는 "토큰"이며 요청된 필드는 "이름"이며 인수는 "id"입니다.

그래프QL
query GetToken($name: String) {
 token: EnjinTokens(
   name: $name
 ) {
   id
 }
}

그래피QL: 그래프QL의 비주얼 인터페이스

아마도 GraphQL의 가장 사용자 친화적 인 기능은 시각적 인터페이스, 작성, 유효성 검사 및 GraphQL 쿼리를 테스트하기위한 브라우저 도구입니다.

API를 쿼리하기 전에 시각적 인터페이스를 통해 쿼리를 실행하여 쿼리가 올바른지 확인하고 반환되는 데이터가 예상되는 데이터인지 확인하는 것이 좋습니다.

다음 GraphiQL 웹 인터페이스를 사용하여 신뢰할 수 있는 클라우드와 상호 작용할 수 있습니다.

그래피QL 데스크탑 앱

또한 신뢰할 수 있는 클라우드와 상호 작용하기 위해 그래피QL의 데스크톱 버전을 다운로드할 수도 있습니다.

윈도우 다운로드 : https://www.electronjs.org/apps/graphiql

데스크톱 앱 내에서 사용할 끝점은 다음과 같습니다.

엔진 개체 유형 쿼리

쿼리는 데이터를 요청하는 방법이며 REST 기반 API의 GET 작업과 유사합니다.

다음은 API를 통해 쿼리할 수 있는 Enjin 개체 유형 목록입니다.

  • 엔진앱: 이 쿼리를 사용하여 Enjin 플랫폼에서 앱에 대한 정보를 얻을 수 있습니다.
  • 엔진앱스: 이 쿼리를 사용하여 Enjin 플랫폼에서 여러 앱에 대한 정보를 얻을 수 있습니다.
  • 엔진밸런스: 이 쿼리를 사용하여 Enjin 플랫폼에 저장된 잔액에 대한 정보를 얻을 수 있습니다.
  • 엔진아이덴티티: 이 쿼리를 사용하여 Enjin 플랫폼에 저장된 ID에 대한 정보를 얻을 수 있습니다.
  • 엔진아이덴티티: 게임에 대한 사용자의 ID입니다.
  • 엔진오우트: 이 쿼리를 사용하여 사용자를 로그인하고 oAuth 액세스 토큰을 가져옵니다.
  • 엔진플랫폼: 이 쿼리를 사용하여 Enjin 플랫폼에서 프로젝트에 대한 정보를 얻을 수 있습니다.
  • 엔진토큰이벤트: Enjin 플랫폼에서 기록된 토큰 이벤트를 쿼리하려면 이 방법을 사용합니다.
  • 엔진토큰: 이 쿼리를 사용하여 토큰 데이터를 가져옵니다.
  • 엔진거래: 트랜잭션 요청을 쿼리하려면 이 것을 사용합니다.
  • 엔진우저: 이 쿼리를 사용하여 Enjin 플랫폼에서 사용자에 대한 정보를 얻을 수 있습니다.
  • 엔진사용자: Enjin 플랫폼에서 사용자 데이터를 쿼리하는 데 사용합니다.
  • 엔진지갑: 이 쿼리를 사용하여 지갑 데이터를 가져옵니다.

엔진 오브젝트 형식 돌연변이

GraphQL에서 돌연변이하는 것은 데이터를 수정하는 방법이며 GET 이외의 모든 비 API 함수를 포함하는 데 사용되는 용어입니다. 여기에는 REST 기반 API에서 잘 알고 있을 수 있는 PUT, POST 및 DELETE와 같은 기능이 포함됩니다.

쿼리와 달리 돌연변이를 하려면 모든 인수를 돌연변이에 추가해야 합니다. 실행한 후 돌연변이가 발생한 후 개체의 값을 쿼리할 수 있습니다.

API를 통해 변질할 수 있는 Enjin 개체 유형유형이 다릅니다.

다음은 돌연변이할 수 있는 Enjin 개체 유형 목록입니다.

  • CreateEnjinApp: 이 돌연변이를 사용하면 Enjin 플랫폼에서 새로운 프로젝트를 만들 수 있습니다.
  • 업데이트엔진앱: 이 돌연변이를 사용하면 이름이나 이미지와 같은 프로젝트의 세부 정보를 업데이트할 수 있습니다.
  • DeleteEnjinApp: 이 돌연변이를 사용하면 Enjin 플랫폼에서 프로젝트를 삭제할 수 있습니다. 이 작업을 프로젝트 작성자만 수행할 수 있습니다.
  • CreateEnjinIdentity: 이 돌연변이를 사용하면 Enjin 플랫폼에서 사용자를 위한 새로운 ID를 만들 수 있습니다.
  • 업데이트엔진아이덴티티: 이 돌연변이를 사용하면 ID를 업데이트할 수 있습니다. 이 돌연변이는 또한 서명된 메시지와 지갑을 연결하는 데 사용됩니다.
  • 삭제엔진정체성: 이 돌연변이를 사용하면 Enjin 플랫폼에서 신원을 삭제할 수 있습니다. 이 돌연변이를 사용하여 지갑에서 ID를 연결할 수도 있습니다.
  • CreateEnjinRequest: 이 돌연변이를 사용하면 블록 체인으로 보낼 수있는 새로운 트랜잭션 요청을 만들 수 있으며 다른 스마트 계약 방법과 상호 작용하는 주요 방법입니다. 트랜잭션 요청을 만들 때 올바른 ID ID를 요청의 '작성자'로 사용하므로 조작중인 토큰의 작성자 또는 소유자와 일치해야 하므로 올바른 ID ID를 사용하는 것이 중요합니다. 요청 만들기의 경우 ID는 새 토큰의 '작성자'가 됩니다.
  • 업데이트엔진 요청: 이 돌연변이를 사용하면 아직 서명되지 않은 보류 중인 트랜잭션 요청을 업데이트하고 블록 체인으로 브로드캐스트 할 수 있습니다.
  • DeleteEnjinRequest: 이 돌연변이를 사용하면 아직 서명되지 않은 트랜잭션 요청을 취소하고 블록 체인으로 브로드 캐스트 할 수 있습니다.
  • CreateEnjinUser: 이 돌연변이를 사용하면 Enjin 플랫폼에서 응용 프로그램에 대한 플레이어를 만들 수 있습니다.
  • 언링크앱: 이 돌연변이를 사용하면 프로젝트에서 지갑을 연결할 수 있습니다.
  • 연결 해제 ID: 이 돌연변이를 사용하면 ID에서 지갑을 연결할 수 있습니다.
  • 무효화토큰메타데이터: 토큰의 메타데이터를 즉시 무효화합니다.

GraphiQL 설명서 탐색기에서 이러한 개체 유형을 사용하여 쿼리및 변형할 수 있는 데이터에 대한 포괄적인 정보를 찾을 수 있습니다.

이를 찾으려면 GraphiQL 시각적 인터페이스로 이동하여 오른쪽 상단 모서리에 있는 "문서" 버튼을 클릭합니다.

변수 쿼리

당신은 우리의 docucumetation에서 알 수 있습니다, 우리는 당신이 사용할 수있는 우리의 쿼리와 돌연변이의 예를 제공하고 그들은 종종 그 안에 vairables을 포함합니다. 페이지 하단의 "쿼리 변수" 섹션의 데이터를 전달하기만 하면 이러한 변수를 쿼리할 수 있습니다.

아래쪽 막대(쿼리 변수)를 밀어내고 변수와 해당 데이터를 입력하기 만 하면 됩니다.

엔진 링크 플랫폼

이전
다음
이 페이지에서