Le query GraphQL possono essere inviate come normali richieste POST tramite HTTP. La query definisce quali dati devono essere restituiti nella risposta.
Le richieste vengono inviate come JSON con la seguente struttura nel corpo della richiesta:
{
"query": "{ allEntries(first: 10) { nodes { id name } } }",
"variables": {}
}
La richiesta deve essere inviata all'URL dell'endpoint https://api.ginto.guide/graphql e deve contenere le seguenti informazioni:
Content-Type: application/json (intestazione)Accept: application/graphql-response+json, application/json (intestazione)Authorization: Bearer {apiKey} (intestazione con la tua chiave API)Accept-Language (intestazione per specificare la lingua desiderata: de, en, fr o it)In caso di successo, il server risponde con un oggetto JSON contenente l'oggetto data. Se si verifica un errore, la risposta può contenere un array errors. In questo caso, l'oggetto data è NULL o parzialmente presente.
Esempio con 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":{}}'
Sostituisci YOUR_API_KEY con la tua chiave API effettiva. L'intestazione Accept-Language è facoltativa. Rimuovila o modifica de (tedesco) in en (inglese), fr (francese) o it (italiano) se necessario.
