---
metadata:
  - name: generator
    content: Diplodoc Platform v5.63.0
alternate:
  - en/operations/connection/create-api-connector
  - ru/operations/connection/create-api-connector
  - href: ru/operations/connection/create-api-connector.md
    type: text/markdown
    title: Markdown version
csp:
  - script-src:
      - https://mc.yandex.ru
    img-src:
      - https://mc.yandex.ru
    connect-src:
      - https://mc.yandex.ru
      - wss://mc.yandex.ru
    child-src:
      - 'blob:'
      - https://mc.yandex.ru
    frame-src:
      - 'blob:'
      - https://mc.yandex.ru
    frame-ancestors:
      - 'blob:'
      - https://mc.yandex.ru
canonical: ru/operations/connection/create-api-connector.html
title: Как создать подключение API Connector в DataLens On-premises
description: >-
  Следуя данной инструкции, вы сможете создать подключение API Connector в
  DataLens On-premises.
vcsPath: ru/operations/connection/create-api-connector.md
---

# Создание подключения API Connector


API Connector в DataLens On-premises позволяет отправлять HTTP-запросы к произвольному API в интернете. Подключение можно использовать только в [Editor](../../charts/editor/index.md), оно не поддерживается в [QL-чартах](../../concepts/chart/ql-charts.md), а также в [чартах на основе датасета](../../concepts/chart/dataset-based-charts.md).

Чтобы создать подключение API Connector:

1. Выберите воркбук для создания подключения и нажмите **Создать** → **Подключение**.
1. В разделе **Файлы и сервисы** выберите подключение **API Connector**.
1. Укажите параметры подключения:

   * **Имя хоста**. Укажите путь до хоста, к которому будет сделан запрос.
   * **Порт**. Укажите порт подключения к API.
   * **URL путь**. (опционально) Укажите путь к API (часть [URL-адреса](https://developer.mozilla.org/ru/docs/Learn/Common_questions/Web_mechanics/What_is_a_URL) без протокола, имени хоста и порта).
   * **HTTPS**. Активируйте опцию безопасного подключения, если ваш сервер поддерживает протокол HTTPS.
   * **Разрешённые методы**. Выберите метод для HTTP-запроса к API. Доступны методы: `GET`, `POST`, `PUT`, `PATCH` и `DELETE`.
   * Добавьте открытые и приватные заголовки к HTTP-запросу в виде пар ключ-значение. Для этого нажмите кнопку **Добавить**, выберите заголовок и введите его значение.

     * **Открытые заголовки запроса** не содержат чувствительных данных. Значения открытых заголовков можно свободно просматривать в настройках подключения. Доступны следующие открытые заголовки:
     
       * `Accept-Charset` — перечень поддерживаемых кодировок для ответа.
       * `Accept-Encoding` — перечень поддерживаемых способов кодирования содержимого для ответа.
       * `Accept-Language` — список поддерживаемых естественных языков.
       * `Prefer` — код состояния HTTP, который следует отправить в ответ.
     
     * **Приватные заголовки запроса** предназначены для передачи чувствительных данных. Значения приватных заголовков хранятся в зашифрованном виде, их нельзя просматривать в настройках подключения, но можно заменять новыми значениями. Доступны следующие приватные заголовки:

       * `Authorization` — данные для аутентификации в API.
       * `X-Api-Key` — API-ключ для аутентификации в ClickHouse®.
       * `X-ClickHouse-User` — имя пользователя для аутентификации в ClickHouse®.
       * `X-ClickHouse-Key` — пароль пользователя для аутентификации в ClickHouse®.

   ![image](../../_assets/datalens/operations/connection/connection-api.png)

1. Нажмите кнопку **Создать подключение**.
1. Выберите [воркбук](../../workbooks-collections/index.md), в котором сохранится подключение, или создайте новый. Если вы пользуетесь старой навигацией по папкам, выберите папку для сохранения подключения. Нажмите кнопку **Создать**.
1. Укажите название подключения и нажмите кнопку **Создать**.


<!-- source: ru/_includes/clickhouse-disclaimer.md -->
_ClickHouse® является зарегистрированным товарным знаком [ClickHouse, Inc](https://clickhouse.com)._
<!-- endsource: ru/_includes/clickhouse-disclaimer.md -->