---

Blue API — это мощный инструмент, который позволяет вам программно взаимодействовать с данными и функциональностью Blue. Вот некоторые возможности, которые вы можете реализовать с помощью Blue API:

Blue API предлагает ряд мощных возможностей, которые позволяют вам программно взаимодействовать с данными и функциональностью Blue.

Давайте подробнее рассмотрим эти возможности.

Чтение данных

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

Запись данных

С помощью Blue API вы можете изменять данные на сервере, используя мутации. Эти мутации позволяют вам создавать новые записи, обновлять существующие или удалять данные по мере необходимости. Это дает вам полный контроль над данными в вашей инстанции Blue, позволяя вам автоматизировать процессы или интегрировать Blue с другими системами в вашем рабочем процессе.

Для массовых операций API предоставляет конкретные мутации, такие как createCustomFieldOptions, deleteFiles и uploadFiles. Хотя общие массовые операции создания/обновления для всех сущностей недоступны, вы можете эффективно обрабатывать несколько операций, отправляя несколько мутаций в одном запросе GraphQL.

Обновление в реальном времени

Одной из самых мощных функций Blue API является поддержка подписок. Это позволяет клиентам слушать изменения данных в реальном времени без необходимости постоянного опроса. Вы можете настроить подписки, чтобы получать уведомления сразу, когда определенные данные изменяются, что позволяет вам создавать отзывчивые приложения, которые всегда отображают самую актуальную информацию.

Эффективное получение данных

API разработан для уменьшения избыточного получения данных. В отличие от традиционных REST API, где вы можете получить больше данных, чем вам нужно, с помощью Blue API вы можете точно указать, какие поля вы хотите получить. Это не только уменьшает объем данных, передаваемых по сети, но и улучшает производительность ваших приложений, минимизируя обработку ненужных данных.

API включает ограничение глубины запросов (максимум 10 уровней), чтобы предотвратить проблемы с производительностью и потенциальное злоупотребление чрезмерно вложенными запросами. Это обеспечивает оптимальную производительность, позволяя при этом сложное извлечение данных.

Интроспекция схемы

Blue API предоставляет возможность динамически открывать и исследовать свои возможности. Это означает, что вы можете запрашивать сам API, чтобы понять, какие запросы, мутации и типы доступны. Эта функция невероятно полезна для разработчиков, так как она позволяет легко исследовать возможности API и помогает в создании надежных, защищенных от будущих изменений интеграций.