Les requêtes GraphQL peuvent être envoyées sous forme de requête POST standard via HTTP. La requête définit les données qui 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 de 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 pour spécifier la langue souhaitée : de, en, fr ou it)En cas de succès, le serveur répond avec un objet JSON contenant l'objet data. Si une erreur survient, la réponse peut contenir un tableau errors. Dans ce cas, l'objet data est soit NULL, 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 réelle. L'en-tête Accept-Language est optionnel. Supprimez-le ou remplacez de (allemand) par en (anglais), fr (français) ou it (italien) si nécessaire.
