Le query GraphQL possono essere inviate come richieste POST standard tramite HTTP. In questo caso, la query specifica quali dati devono essere restituiti nella risposta.
Le richieste vengono inviate in formato 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 selezionare la lingua desiderata: de, en, fr oppure it)Se l'operazione va a buon fine, il server risponde con un oggetto JSON contenente l'oggetto data. Se si verifica un errore, la risposta può contenere un array errors. In tal caso, l'oggetto data è ZERO oppure è presente solo in parte.
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, se necessario, modifica de (tedesco) in en (inglese), fr (francese) o it (italiano).
