---
title: "Получить подключения и вебхуки автоматизаций"
method: GET
path: "/api/v1/automation/connections"
tags: ["Automation"]
---

# Получить подключения и вебхуки автоматизаций

`GET /api/v1/automation/connections`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/automation/connections`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://erp.akeda.ru/oauth2/authorize`, token URL `https://erp.akeda.ru/oauth2/token`, scopes: `akeda:delegate`)

Внешние подключения кабинета (адрес, разрешённый домен, способ
авторизации, есть ли секрет, последняя проверка) и входящие вебхуки
(поля образца, подпись, последний приём). Отсюда берут `id`
подключения для действия «Отправить вебхук» и `id` вебхука для события
«Пришёл вебхук», а также `id` установки приложения для действия
«Передать приложению» (`installations`: имя, издатель, готовность
принимать передачи и причина, если не примет; без прав и адресов).

Секреты подключений и подписи, токен адреса вебхука в ответе не
возвращаются никогда: виден только признак `has_secret`. Заводит
подключения и вебхуки человек на экране «Настройки → Автоматизации →
Вебхуки и API».

## Headers

- `X-Tenant` string, required

## Response `200`

Подключения и вебхуки кабинета

- object
  - `connections` AutomationConnection[], required
    - `id` string, uuid, required
    - `name` string, required
    - `base_url` string, required: Базовый адрес; путь действия дописывается к нему
    - `host` string, required: Разрешённый домен: вызов уходит только на него
    - `auth_kind` 'none' | 'header' | 'bearer' | 'basic' | 'hmac', required: Способ авторизации
    - `auth_header` string: Имя заголовка с секретом при способе header
    - `basic_user` string: Логин при способе basic
    - `has_secret` boolean, required: Задан ли секрет; сам секрет не возвращается
    - `enabled` boolean, required
    - `last_check` AutomationConnectionCheck: Последняя проверка подключения по кнопке на экране.
      - `at` string, date-time, required
      - `ok` boolean, required
      - `status` integer: HTTP-статус ответа приёмника
      - `duration_ms` integer, required
      - `code` 'unreachable' | 'blocked' | 'timeout' | 'http_error': Почему не ответил; нет поля — ответил
    - `created_by` integer, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `webhooks` AutomationWebhook[], required
    - `id` string, uuid, required
    - `name` string, required
    - `signature` 'none' | 'hmac_sha256', required: Проверка подписи входящего вызова
    - `fields` AutomationWebhookField[], required: Поля события, выведенные из образца
      - `path` string, required: Плоский путь поля в теле (a.b)
      - `type` 'string' | 'number' | 'bool' | 'date', required
    - `enabled` boolean, required
    - `last_received_at` string, date-time: Когда вебхук принимал вызов последний раз
    - `created_by` integer, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `installations` AutomationAppInstallation[], required: Установки приложений кабинета (кроме удалённых) для действия «Передать приложению»
    - `id` string, uuid, required: Идентификатор установки — вход installation_id действия
    - `title` string, required: Название приложения
    - `publisher` string, required: Издатель
    - `app_key` string, required: Ключ приложения у издателя
    - `active` boolean, required: Установка включена, издатель, приложение и версия не выключены платформой
    - `receiver` boolean, required: У установки есть адрес доставки событий
    - `subscribed` boolean, required: Манифест версии подписан на app.automation.delivered.v1
    - `granted` boolean, required: Кабинет дал право app.automation:read
    - `ready` boolean, required: Передача дойдёт до установки
    - `missing` 'app_installation_disabled' | 'app_no_receiver' | 'app_consent_missing': Первая причина, по которой не дойдёт; пусто у готовой
  - `auth_kinds` string[], required: Способы авторизации подключения в порядке показа
  - `hook_path_prefix` string, required: Начало адреса приёма вебхука; полный адрес с токеном показывается человеку один раз при выпуске
  - `allow_local` string[], required: Локальные приёмники, разрешённые стенду; в бою пусто

## Other responses

- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права

---

[API](https://skmtc.dev/akeda/apis/akeda-erp-client-api.md) · [All operations](https://skmtc.dev/akeda/apis/akeda-erp-client-api/llms.txt) · [OpenAPI document](https://skmtc.dev/akeda/apis/akeda-erp-client-api/revisions/3c60ded179f2?raw)