Habilitación del editor GraphiQL para una API de GraphQL

Si selecciona la opción Habilitar editor GraphiQL al crear una API de proxy GraphQL , los usuarios pueden probar la API utilizando un editor GraphiQL en un navegador web; API Connect responde a la solicitud inicial del editor GraphiQL con una página HTML que permite realizar pruebas desde el editor GraphiQL .

La inhabilitación de la opción Habilitar editor de GraphiQL reduce el tráfico de pasarela y la latencia y, además, el Portal del desarrollador proporciona una capacidad de prueba equivalente independientemente de si habilita o no la opción.

Esta opción añade automáticamente el valor de propiedad siguiente al origen de OpenAPI para la API de proxy de GraphQL:

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

Si inhabilita la opción Habilitar editor GraphiQL durante la creación de la API y más adelante decide que es necesaria, puede añadir manualmente este valor de propiedad o seleccionar Habilitar editor GraphiQL en la página Configuración de API de la pestaña Diseñar de la API.

Nota:

La propiedad html-page sólo debe utilizarse con una API de proxy GraphQL.
store:///graphiql.html es el único valor permitido para la propiedad html-page.
Si añade la propiedad html-page, pero la propiedad Admitir introspección estándar no se ha habilitado durante la creación de la API, la página HTML de GraphiQL no mostrará ninguna documentación relativa al servidor de fondo de GraphQL, realizará ninguna validación ni realizará búsqueda inteligente. Para obtener detalles sobre cómo crear manualmente la configuración de política de ensamblaje necesaria, consulte Soporte de introspección para una API GraphQL.