Phone icon Связаться с нами

API и интеграции

Что такое GraphQL?

GraphQL — это язык запросов к API и способ его построения, при котором клиент сам описывает, какие данные ему нужны. Сервер возвращает ровно эти поля — не больше и не меньше — в формате JSON.

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

Есть три вида операций: запросы (query) для чтения, мутации (mutation) для изменения данных и подписки (subscription) для получения обновлений в реальном времени. GraphQL создали в Facebook для мобильного приложения и открыли для всех в 2015 году.

Где применяется

GraphQL используют там, где разным клиентам нужны разные наборы данных: веб-сайту — много полей, мобильному приложению — только самые необходимые. Его выбирают для сложных интерфейсов, где одна страница показывает данные из многих источников, и для API, которыми пользуются внешние разработчики.

Фронтенд-разработчик работает с GraphQL через клиенты вроде Apollo Client или urql, а бэкенд-разработчик описывает схему и пишет обработчики полей. В вакансиях GraphQL обычно идёт как плюс к REST API, а не вместо него.

Пример

Странице профиля нужны имя пользователя и три последних заказа с суммами. В REST это могло бы быть два-три запроса к разным адресам. В GraphQL — один запрос, и в ответе только нужные поля.

query {
  user(id: 42) {
    name
    orders(last: 3) {
      id
      total
    }
  }
}
Запрос GraphQL: клиент сам определяет структуру ответа.

GraphQL и REST API: в чём разница

В REST у каждого ресурса свой адрес, а структуру ответа определяет сервер. Из-за этого клиент часто получает лишние данные или делает несколько запросов. В GraphQL один адрес, а форму ответа задаёт клиент. Зато REST проще кешировать и отлаживать, поэтому он остаётся стандартом для большинства API.

Частые вопросы

Заменит ли GraphQL REST API?

Нет, они сосуществуют. REST проще, лучше кешируется на уровне HTTP и подходит для большинства сервисов. GraphQL выигрывает там, где много разных клиентов и сложные связи между данными. Часто в одной компании есть оба подхода.

Что такое схема в GraphQL?

Это описание всех типов данных и операций, доступных в API: какие объекты есть, какие у них поля и каких типов, какие запросы и мутации можно выполнить. Схема одновременно является документацией и контрактом между фронтендом и бэкендом.

Что такое мутация в GraphQL?

Операция, которая изменяет данные: создаёт, обновляет или удаляет записи. Например, оформление заказа или изменение профиля. Как и в запросах, в мутации клиент указывает, какие поля хочет получить в ответе после изменения.

Какие минусы у GraphQL?

Более сложное кеширование, потому что все запросы идут на один адрес. Риск очень тяжёлых запросов, которые нагружают сервер, — их ограничивают по глубине и сложности. И более высокий порог входа для команды: нужно освоить схему, обработчики и инструменты.

Обучение программированию в OWU

Освойте профессию в IT на практических курсах с менторами и реальными проектами.

Выбрать курс