How It Works
tl;dr
The internal /api/__kql
server route proxies KQL requests to the Kirby instance.
Detailed Answer
The useKql
and $kql
composables will initiate a POST request to the Nuxt server route /api/__kql
defined by this module. The KQL query will be encoded in the request body.
The internal server route then fetches the actual data for a given query from the Kirby instance and passes the response back to the client. Thus, no KQL requests to the Kirby instance are initiated on the client-side. This proxy behavior has the benefit of omitting CORS issues, since data is sent from server to server.
During server-side rendering, calls to the Nuxt server route will directly call the relevant function (emulating the request), saving an additional API call. Thus, only the fetch request from Nuxt to Kirby will be performed.
INFO
Query responses are cached (with a key calculated by hashing the query) and hydrated to the client. Subsequent calls will return cached responses, saving duplicated requests. Head over to the caching section to learn more.