GraphQL API에 대해 GraphiQL 편집기 사용

GraphQL 프록시 API를 작성할 때 GraphiQL 편집기 사용 옵션을 선택하는 경우 사용자는 웹 브라우저에서 GraphiQL 편집기를 사용하여 API를 테스트할 수 있습니다. API Connect 는 GraphiQL 편집기에서 테스트를 사용으로 설정하는 HTML 페이지로 초기 GraphiQL 편집기 요청에 응답합니다.

GraphiQL 편집기 사용 옵션을 사용 안함으로 설정하면 게이트웨이 트래픽 및 대기 시간이 줄어들고, 또한 개발자 포털 은 옵션을 사용으로 설정했는지 여부에 관계없이 동등한 테스트 기능을 제공합니다.

이 옵션은 자동으로 다음 특성 설정을 GraphQL 프록시 API를 위한 OpenAPI 소스에 추가합니다.

html-page: 'store:///graphiql.html'

API 작성 동안 GraphiQL 편집기 사용을 사용 안함으로 설정하고 이후 필요한 경우, 수동으로 이 특성 설정을 추가하거나 API의 디자인 탭의 API 설정 페이지에서 GraphiQL 편집기 사용을 선택할 수 있습니다.

참고:

html-page 특성은 GraphQL 프록시 API로만 사용되어야 합니다.
store:///graphiql.html은 html-page 특성에 대해 허용된 유일한 값입니다.
html-page 특성을 추가하지만 표준 검사 지원 특성이 API 작성 동안 사용으로 설정되지 않았으면, GraphiQL HTML 페이지는 GraphQL 백엔드 서버에 관한 문서를 표시하지 않으며 조회 유효성 검증을 수행하거나 스마트한 검색을 수행하지 않습니다. 필수 어셈블리 정책 구성을 수동으로 작성하는 방법에 대한 세부사항은 GraphQL API에 대한 자체 검사 지원을 참조하십시오.