Les requêtes GraphQL peuvent être envoyées sous forme de requêtes POST standard via HTTP. La requête définit alors quelles données doivent être renvoyées dans la réponse.
Les requêtes sont envoyées au format JSON avec la structure suivante dans le corps de la requête :
{
"query": "{ allEntries(first: 10) { nodes { id name } } }",
"variables": {}
}
La requête doit être envoyée à l'URL du point de terminaison https://api.ginto.guide/graphql et doit contenir les informations suivantes :
Content-Type: application/json (En-tête)Accept: application/graphql-response+json, application/json (En-tête)Authorization: Bearer {apiKey} (En-tête avec votre clé API)Accept-Language (En-tête permettant de sélectionner la langue souhaitée : de, en, fr ou it)Lorsque les opérations aboutissent, le serveur renvoie un objet JSON contenant l'objet data. En cas d'erreur, la réponse peut contenir un tableau errors. Dans ce cas, l'objet data est soit NUL, soit partiellement présent.
Exemple avec cURL:
curl -X POST https://api.ginto.guide/graphql \
-H "Content-Type: application/json" \
-H "Accept: application/graphql-response+json, application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Accept-Language: de" \
-d '{"query":"{ allEntries(first: 10) { nodes { id name } } }","variables":{}}'
Remplacez YOUR_API_KEY par votre clé API. L'en-tête Accept-Language est facultatif. Supprimez-le ou remplacez de (allemand) par en (anglais), fr (français) ou it (italien) si nécessaire.
