Persisted Queries
Gebruik GraphQL queries om vooraf gedefinieerde endpoints te maken zoals in REST, en geniet van de voordelen van beide API's.
Click to watch tutorial video - 08:19
In een REST API maak je meerdere endpoints, elk met een vooraf gedefinieerde set gegevens. In een GraphQL API stuur je daarentegen elke query naar één enkel endpoint, dat precies de gevraagde gegevens retourneert.
Persisted queries zijn gewone GraphQL queries, maar ze worden opgeslagen op de server en zijn toegankelijk via hun eigen URL, waardoor ze een REST-endpoint nabootsen. Ze bieden de voordelen van beide API's, terwijl de nadelen worden vermeden:
| Voordelen | Nadelen |
|---|---|
✅ Toegankelijk via GET of POST | POST |
| ✅ Kan worden gecached op de server of CDN | |
| ✅ Het is veilig: alleen bedoelde gegevens worden blootgesteld | |
| ✅ Geen under/over fetching van gegevens; alle gegevens worden opgehaald in één verzoek | |
| ✅ Het maakt snelle iteratie van het project mogelijk | |
| ✅ Het kan zelf-gedocumenteerd zijn | |
| ✅ Het stelt clients in staat om queries te maken en te publiceren |
Zodra de persisted query is gepubliceerd, kun je deze uitvoeren via de permalink.
De persisted query kan worden uitgevoerd via de GraphiQL client, of ook rechtstreeks in de browser (omdat deze toegankelijk is via GET), en je krijgt de gevraagde gegevens in JSON-formaat:
Persisted queries kunnen worden beheerd via categorieën en hiërarchieën.
