GraphQL은 쿼리의 데이터 구조를 정의하고 원하는 것과 더 이상 아무것도 요청할 수 있는 최신 쿼리 언어입니다.
GraphQL 쿼리는 한 리소스의 속성뿐만 아니라 리소스 간의 참조를 원활하게 따르도록 액세스합니다. 일반적인 REST API는 여러 URL에서 로드해야 하지만 GraphQL API는 앱이 단일 요청에서 필요한 모든 데이터를 가져옵니다.
쿼리: 읽기 작업은 GraphQL 쿼리에 의해 수행되며 이러한 작업은 데이터를 변경하지 않습니다.
돌연변이: 돌연변이를 사용하여 다른 모든 작업을 수행하여 데이터를 수정합니다.
개체 유형은 API에서 쿼리할 수 있는 데이터 집합을 정의하는 데 사용되는 필드 집합입니다.
query {
}
mutation {
}
필드는 특정 개체 속성을 요청하는 데 사용됩니다.
각 개체에는 필요한 속성을 쿼리하기 위해 이름으로 쿼리할 수 있는 필드가 있습니다.
query {
EnjinToken {
id
}
}
인수를 전달하여 쿼리의 반환 값을 결정할 수 있습니다. 이렇게 하면 결과가 좁아지고 후에 필요한 것만 얻을 수 있습니다.
다음 예제에서 개체는 "토큰"이며 요청된 필드는 "이름"이며 인수는 "id"입니다.
query GetToken($name: String) {
token: EnjinTokens(
name: $name
) {
id
}
}
아마도 GraphQL의 가장 사용자 친화적 인 기능은 시각적 인터페이스, 작성, 유효성 검사 및 GraphQL 쿼리를 테스트하기위한 브라우저 도구입니다.
API를 쿼리하기 전에 시각적 인터페이스를 통해 쿼리를 실행하여 쿼리가 올바른지 확인하고 반환되는 데이터가 예상되는 데이터인지 확인하는 것이 좋습니다.
다음 GraphiQL 웹 인터페이스를 사용하여 신뢰할 수 있는 클라우드와 상호 작용할 수 있습니다.
또한 신뢰할 수 있는 클라우드와 상호 작용하기 위해 그래피QL의 데스크톱 버전을 다운로드할 수도 있습니다.
윈도우 다운로드 : https://www.electronjs.org/apps/graphiql
데스크톱 앱 내에서 사용할 끝점은 다음과 같습니다.
쿼리는 데이터를 요청하는 방법이며 REST 기반 API의 GET 작업과 유사합니다.
다음은 API를 통해 쿼리할 수 있는 Enjin 개체 유형 목록입니다.
GraphQL에서 돌연변이하는 것은 데이터를 수정하는 방법이며 GET 이외의 모든 비 API 함수를 포함하는 데 사용되는 용어입니다. 여기에는 REST 기반 API에서 잘 알고 있을 수 있는 PUT, POST 및 DELETE와 같은 기능이 포함됩니다.
쿼리와 달리 돌연변이를 하려면 모든 인수를 돌연변이에 추가해야 합니다. 실행한 후 돌연변이가 발생한 후 개체의 값을 쿼리할 수 있습니다.
API를 통해 변질할 수 있는 Enjin 개체 유형유형이 다릅니다.
다음은 돌연변이할 수 있는 Enjin 개체 유형 목록입니다.
GraphiQL 설명서 탐색기에서 이러한 개체 유형을 사용하여 쿼리및 변형할 수 있는 데이터에 대한 포괄적인 정보를 찾을 수 있습니다.
이를 찾으려면 GraphiQL 시각적 인터페이스로 이동하여 오른쪽 상단 모서리에 있는 "문서" 버튼을 클릭합니다.
당신은 우리의 docucumetation에서 알 수 있습니다, 우리는 당신이 사용할 수있는 우리의 쿼리와 돌연변이의 예를 제공하고 그들은 종종 그 안에 vairables을 포함합니다. 페이지 하단의 "쿼리 변수" 섹션의 데이터를 전달하기만 하면 이러한 변수를 쿼리할 수 있습니다.
아래쪽 막대(쿼리 변수)를 밀어내고 변수와 해당 데이터를 입력하기 만 하면 됩니다.