← Analytics / analytics / graphql-api / getting-started

Spusťte dotaz GraphQL pomocí curl

Použití obyčejného curl k odeslání dotazu umožňuje výsledky libovolně rozkrájet a v případě potřeby je dále zpracovat. Můžete je například převést z formátu GraphQL API do formátu CSV.

Další funkce, jako je automatické doplňování nebo prozkoumávání schématu, nabízí GraphQL klienti.

GraphQL API očekává JSON se dvěma povinnými poli: "query" a "variables".

Dotaz je třeba zbavit symbolů nového řádku a odeslat jako jednořádkový řetězec, pokud je proměnná objektem obsahujícím hodnoty pro všechny zástupné symboly použité v dotazu:

Struktura payloadu pro GraphQL API

{
  "query": "{viewer { ... }}",
  "variables": {}
}

I tak je ale možné použít dotaz čitelný pro člověka. V následujícím příkladu uvidíte, jak echo spojené znakem roury s tr k zajištění správného payloadu s curl:

Příklad skriptu bash, který k dotazování Analytics API používá curl

echo '{ "query":
  "{
    viewer {
      zones(filter: { zoneTag: $zoneTag }) {
        firewallEventsAdaptive(
          filter: $filter
          limit: 10
          orderBy: [datetime_DESC]
        ) {
          action
          clientAsn
          clientCountryName
          clientIP
          clientRequestPath
          clientRequestQuery
          datetime
          source
          userAgent
        }
      }
    }
  }",
  "variables": {
    "zoneTag": "<zone-tag>",
    "filter": {
      "datetime_geq": "2022-07-24T11:00:00Z",
      "datetime_leq": "2022-07-24T12:00:00Z"
    }
  }
}' | tr -d '\n' | curl --silent \
https://api.cloudflare.com/client/v4/graphql \
--header "Authorization: Bearer <API_TOKEN>" \
--header "Content-Type: application/json" \
--data @-