## Список подписок

`GET /v1/infra/servers/:id/event-subscriptions`

Возвращает подписки сервера и до 50 недавних доставок. Массив `recentDeliveries` — журнал последних событий со статусом каждой доставки и текстом ошибки, если доставка не удалась. По нему проверяют, доходят ли события до приложения.

## Параметры

| Параметр | В | Тип | Обяз. | Описание |
|----------|---|-----|:-----:|----------|
| `id` | path | string (UUID) | да | ID сервера. Список: [`GET /v1/infra/servers`](/docs/infra/servers) |

## Примеры

### curl — личный ключ

```bash
curl -H "X-Api-Key: YOUR_API_KEY" \
  https://vibecode.bitrix24.tech/v1/infra/servers/SERVER_ID/event-subscriptions
```

### curl — OAuth-приложение

```bash
curl -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  https://vibecode.bitrix24.tech/v1/infra/servers/SERVER_ID/event-subscriptions
```

### JavaScript — личный ключ

```javascript
const res = await fetch(
  `https://vibecode.bitrix24.tech/v1/infra/servers/${serverId}/event-subscriptions`,
  { headers: { 'X-Api-Key': 'YOUR_API_KEY' } }
)
const { success, data, recentDeliveries } = await res.json()
console.log(`Подписок: ${data.length}, доставок в журнале: ${recentDeliveries.length}`)
```

### JavaScript — OAuth-приложение

```javascript
const res = await fetch(
  `https://vibecode.bitrix24.tech/v1/infra/servers/${serverId}/event-subscriptions`,
  {
    headers: {
      'X-Api-Key': 'YOUR_APP_KEY',
      'Authorization': 'Bearer USER_SESSION_TOKEN',
    },
  }
)
const { success, data, recentDeliveries } = await res.json()
```

## Поля ответа

| Поле | Тип | Описание |
|------|-----|----------|
| `success` | boolean | `true` при успехе |
| `data` | array | Массив подписок, новые сверху. Поля каждой подписки — см. [Создать подписку](./create.md) |
| `recentDeliveries` | array | До 50 недавних доставок, новые сверху. Более старых доставок в ответе нет |
| `recentDeliveries[].id` | string (UUID) | ID доставки |
| `recentDeliveries[].event` | string | Код события |
| `recentDeliveries[].status` | string | Статус доставки: `PENDING`, `DELIVERING`, `DELIVERED`, `FAILED` |
| `recentDeliveries[].attempts` | number | Число попыток доставки |
| `recentDeliveries[].lastError` | string \| null | Текст последней ошибки доставки |
| `recentDeliveries[].createdAt` | string | Когда событие поступило (ISO 8601) |
| `recentDeliveries[].deliveredAt` | string \| null | Когда доставлено в приложение (ISO 8601), `null` если ещё не доставлено |

## Пример ответа

```json
{
  "success": true,
  "data": [
    {
      "id": "a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
      "appId": "9a1c2b3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d",
      "serverId": "e765edfc-ba0a-43de-b8ea-838dd872c522",
      "portalId": "8b1f0e2a-3c4d-5e6f-7a8b-9c0d1e2f3a4b",
      "event": "ONTASKADD",
      "appPath": "/api/webhooks/b24",
      "authType": "1",
      "b24Handler": "https://vibecode.bitrix24.tech/v1/portal-events/9a1c2b3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d",
      "status": "ACTIVE",
      "createdById": "7f3a1c2b-9d8e-4a6f-b1c2-3d4e5f6a7b8c",
      "createdAt": "2026-06-07T10:00:00.000Z",
      "updatedAt": "2026-06-07T10:00:00.000Z"
    }
  ],
  "recentDeliveries": [
    {
      "id": "b2c3d4e5-6f7a-8b9c-0d1e-2f3a4b5c6d7e",
      "event": "ONTASKADD",
      "status": "DELIVERED",
      "attempts": 0,
      "lastError": null,
      "createdAt": "2026-06-07T10:05:00.000Z",
      "deliveredAt": "2026-06-07T10:05:01.000Z"
    }
  ]
}
```

## Пример ответа при ошибке

404 — сервер не найден:

```json
{
  "success": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "Server not found"
  }
}
```

## Ошибки

| HTTP | Код | Описание |
|------|-----|----------|
| 403 | `SERVER_ROLE_FORBIDDEN` | Вы состоите в команде разработки этого сервера с ролью «Разработчик», а операция открыта роли «Администратор». В `error.hint` придут ваша роль, требуемый порог и перечень открытых вам вызовов. Разбор ролей — [Список серверов](/docs/infra/servers/list) |
| 404 | `NOT_FOUND` | Сервер не найден или привязан к другому API-ключу, и вы не состоите в его команде разработки |

Полный список общих ошибок API — [Ошибки](/docs/errors).

## Известные особенности

- **Неудачная доставка переводит подписку в `DEGRADED`.** Неуспешные доставки (ответ приложения не `2xx` или сервер недоступен) повторяются с нарастающей задержкой. После исчерпания попыток доставка переходит в `FAILED`, подписка помечается `DEGRADED`, а владелец получает уведомление. Поле `recentDeliveries[].lastError` показывает причину последней неудачи.

## Смотрите также

- [Подписки на события портала](/docs/infra/event-subscriptions)
- [Создать подписку](/docs/infra/event-subscriptions/create)
- [Удалить подписку](/docs/infra/event-subscriptions/delete)
- [Обработчик на стороне приложения](/docs/infra/event-subscriptions/handler)
- [Ошибки](/docs/errors)