Anfrage senden

GraphQL-Abfragen können über HTTP als standardmässige POST-Anfrage gesendet werden. Dabei legt die Abfrage fest, welche Daten in der Antwort zurückgegeben werden.

Anfragen werden im Anfragetext als JSON mit folgender Struktur gesendet:

{
  "query": "{ allEntries(first: 10) { nodes { id name } } }",
  "variables": {}
}

‍

Die Anfrage ist an die Endpunkt-URL https://api.ginto.guide/graphql zu senden und muss die folgenden Informationen enthalten:

Content-Type: application/json (Header)
Accept: application/graphql-response+json, application/json (Header)
Authorization: Bearer {apiKey} (Header mit deinem API-Key)
Optional: Accept-Language (Header, um die gewünschte Sprache anzugeben: de, en, fr oder it)

Bei erfolgreichen Vorgängen antwortet der Server mit einem JSON-Objekt, das das data-Objekt enthält. Tritt ein Fehler auf, kann die Antwort ein errors-Array enthalten. In diesem Fall ist das data-Objekt entweder NULL oder nur teilweise vorhanden.

Beispiel mit 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":{}}'

‍

Ersetze YOUR_API_KEY durch deinen tatsächlichen API-Schlüssel. Der Accept-Language-Header ist optional. Entferne ihn oder ändere de (Deutsch) bei Bedarf in en (Englisch), fr (Französisch) oder or it (Italienisch).