> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8a08bda2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Легко создавайте REST API-эндпоинты из сохранённых запросов

# Эндпоинты Query API

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

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

Возможность **эндпоинта Query API** позволяет создавать конечную точку API напрямую из любого сохранённого SQL-запроса в консоли ClickHouse Cloud.
Вы сможете обращаться к конечным точкам API по HTTP, чтобы выполнять сохранённые запросы без необходимости подключаться к сервису ClickHouse Cloud через нативный драйвер.

<div id="ip-access-control">
  ## Управление доступом по IP
</div>

Эндпоинты Query API учитывают белый список IP-адресов на уровне ключа API. Как и SQL Console, эндпоинты Query API проксируют запросы через инфраструктуру ClickHouse, поэтому настройки белого списка IP на уровне сервиса здесь не действуют.

Чтобы ограничить, какие клиенты могут вызывать ваши эндпоинты Query API:

<Steps>
  <Step>
    #### Откройте настройки ключа API

    1. Перейдите в ClickHouse Cloud Console → **Organization** → **API Keys**

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8a08bda2/5sjhdEeyunylejk6/images/cloud/guides/query-endpoints/console-api-keys.png?fit=max&auto=format&n=5sjhdEeyunylejk6&q=85&s=b349f05b6b817b1d7219fa7d5bcc0e6f" size="md" alt="Ключи API" width="866" height="804" data-path="images/cloud/guides/query-endpoints/console-api-keys.png" />

    2. Нажмите **Edit** рядом с ключом API, который используется для эндпоинтов Query API

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8a08bda2/5sjhdEeyunylejk6/images/cloud/guides/query-endpoints/api-key-edit.png?fit=max&auto=format&n=5sjhdEeyunylejk6&q=85&s=46b9bd2d8dc25ab4893d4914941027d8" size="md" alt="Изменить" width="2506" height="446" data-path="images/cloud/guides/query-endpoints/api-key-edit.png" />
  </Step>

  <Step>
    #### Добавьте разрешенные IP-адреса

    1. В разделе **Allow access to this API Key** выберите **Specific locations**
    2. Введите IP-адреса или диапазоны CIDR (например, `203.0.113.1` или `203.0.113.0/24`)
    3. При необходимости добавьте несколько записей

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8a08bda2/5sjhdEeyunylejk6/images/cloud/guides/query-endpoints/specific-locations.png?fit=max&auto=format&n=5sjhdEeyunylejk6&q=85&s=3f448b27c8c048baf03eb92ea5ec2a18" size="md" alt="Конкретные местоположения" width="1336" height="1740" data-path="images/cloud/guides/query-endpoints/specific-locations.png" />

    Для создания эндпоинтов Query API требуется роль Admin Console и ключ API с соответствующими разрешениями.
  </Step>
</Steps>

<Tip>
  **Руководство**

  Инструкции по быстрой настройке
  эндпоинтов Query API см. в [руководстве по эндпоинтам Query API](/ru/products/cloud/guides/sql-console/query-endpoints)
</Tip>