← Аналитика / analytics / graphql-api / getting-started

Выполнение запроса GraphQL с помощью curl

Использование обычного curl для отправки запроса позволяет произвольно комбинировать результаты и при необходимости обрабатывать их дополнительно. Например, можно преобразовать результаты, полученные от GraphQL API, в формат CSV.

Дополнительные функции, такие как автодополнение и изучение схемы, предоставляет GraphQL клиенты.

GraphQL API ожидает JSON с двумя обязательными полями: "query" и "variables".

Перед отправкой из запроса нужно удалить символы новой строки и передать его одной строкой, если переменные заданы объектом со значениями для всех плейсхолдеров, используемых в запросе:

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

Тем не менее по-прежнему можно использовать запрос, понятный человеку. В примере ниже показано, как echo соединённые оператором канала с tr чтобы указать корректную полезную нагрузку с 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 @-