Creando una jerarquía de API
Los endpoints personalizados y las consultas persistidas pueden organizarse en una jerarquía. Esto se consigue cuando declaran un padre, en cuyo caso sus rutas de endpoint extenderán la ruta del endpoint padre.
Por ejemplo, podemos crear esta jerarquía:
- Consulta persistida padre:
/graphql-query/posts/ - Consulta persistida hija:
/graphql-query/posts/english/ - Consulta persistida hija:
/graphql-query/posts/french/
El número de niveles es ilimitado, por lo que también podemos crear:
/graphql-query/posts//graphql-query/posts/mobile-app//graphql-query/posts/mobile-app/english//graphql-query/posts/mobile-app/french//graphql-query/posts/website//graphql-query/posts/website/english//graphql-query/posts/website/french/
Consulta la guía Estrategias para jerarquías de API para ver posibles configuraciones.
Herencia de propiedades
Los endpoints personalizados y consultas persistidas hijos heredarán propiedades del padre.
Endpoints personalizados y consultas persistidas
Los endpoints personalizados y consultas persistidas hijos heredarán la configuración del esquema del padre.
Solo consultas persistidas
Las consultas persistidas hijas también heredarán la consulta GraphQL y las variables del padre. Los valores de las variables pueden sobrescribirse por el hijo, variable a variable.
Por ejemplo, si el padre declara estas variables:
{
"limit": 5,
"offset": 0
}Y el hijo declara estas variables:
{
"limit": 10
}Entonces, las variables computadas para el hijo serán:
{
"limit": 10,
"offset": 0
}Creando una jerarquía de API
En el endpoint personalizado o la consulta persistida, en los ajustes del documento, hay una sección Atributos de página con un desplegable de todas las demás entidades, para seleccionar como padre:
Consultas persistidas
Al seleccionar un padre, en la consulta persistida se ofrecerá una nueva opción, "Inherit query from ancestor(s)?"
Establece esta opción en Sí, para que la consulta persistida hija herede la consulta GraphQL del padre:
Ejemplo
Esta consulta persistida define su consulta GraphQL, y declara la variable $limit con valor 1:
Una consulta persistida hija la extiende, heredando la consulta GraphQL, y sobrescribiendo el valor de la variable $limit a 2:
