## Список задач

`GET /v1/infra/servers/:id/jobs`

Возвращает все неудалённые задачи сервера, в том числе выключенные, и до пяти последних запусков каждой. Работает и при недоступности функции. Секрет в ответе отсутствует.

Нужен ключ с `vibe:infra` и существующие права на сервер. Для записи — управляющий ключ или роль команды с правом управления жизненным циклом. [Общие правила](../jobs.md); [проверка подписи](./signature.md).

## Параметры

| Параметр | Где | Тип | Обязателен | Описание |
|---|---|---|---|---|
| `id` | path | string | yes | ID сервера из [списка серверов](../servers.md) |

Тело запроса и query-параметры не нужны. Для POST без тела не передавайте Content-Type: application/json; пустое JSON-тело отвергается до обработчика.

## Примеры

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

```bash
curl --max-time 20 -X GET "https://vibecode.bitrix24.tech/v1/infra/servers/SERVER_ID/jobs" \
  -H "X-Api-Key: YOUR_API_KEY"
```

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

```bash
curl --max-time 20 -X GET "https://vibecode.bitrix24.tech/v1/infra/servers/SERVER_ID/jobs" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN"
```

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

```javascript
const serverId = 'SERVER_ID';
const res = await fetch(`https://vibecode.bitrix24.tech/v1/infra/servers/${encodeURIComponent(serverId)}/jobs`, {
  method: 'GET',
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
  },
});
const result = await res.json();
if (!res.ok || !result.success) throw new Error(result.error?.code ?? `HTTP_${res.status}`);
console.log(result);
```

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

```javascript
const serverId = 'SERVER_ID';
const res = await fetch(`https://vibecode.bitrix24.tech/v1/infra/servers/${encodeURIComponent(serverId)}/jobs`, {
  method: 'GET',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
  },
});
const result = await res.json();
if (!res.ok || !result.success) throw new Error(result.error?.code ?? `HTTP_${res.status}`);
console.log(result);
```

## Ответ

HTTP 200. Пример формы ответа с вымышленными идентификаторами, не результат живого запроса.

```json
{
  "success": true,
  "data": {
    "items": [
      {
        "id": "job_example",
        "serverId": "server_example",
        "label": "daily digest",
        "cronExpr": "0 9 * * *",
        "timezone": "Europe/Moscow",
        "path": "/tasks/digest?mode=daily",
        "enabled": true,
        "nextScheduledFor": "2026-10-11T06:00:00.000Z",
        "scheduleRevision": 1,
        "availableSince": "2026-10-09T10:00:00.000Z",
        "createdAt": "2026-10-09T10:00:00.000Z",
        "updatedAt": "2026-10-09T10:00:00.000Z",
        "latestRuns": [
          {
            "id": "run_example",
            "jobId": "job_example",
            "serverId": "server_example",
            "portalId": "account_example",
            "path": "/tasks/digest?mode=daily",
            "scheduleRevision": 1,
            "trigger": "SCHEDULE",
            "scheduledFor": "2026-10-10T06:00:00.000Z",
            "status": "SUCCEEDED",
            "attempts": 1,
            "nextAttemptAt": null,
            "readyDeadlineAt": "2026-10-10T06:30:00.000Z",
            "deliveryDeadlineAt": "2026-10-14T06:00:00.000Z",
            "waitingForServer": false,
            "startedAt": "2026-10-10T06:00:02.000Z",
            "lastAttemptStartedAt": "2026-10-10T06:00:02.000Z",
            "late": false,
            "finishedAt": "2026-10-10T06:00:02.150Z",
            "durationMs": 150,
            "responseSource": "app",
            "httpStatus": 202,
            "errorCode": null,
            "lastAttemptErrorCode": null,
            "requestId": "request_example",
            "responseSnippet": "{\"accepted\":true}",
            "createdAt": "2026-10-10T06:00:00.000Z",
            "updatedAt": "2026-10-10T06:00:02.150Z"
          }
        ]
      }
    ]
  }
}
```

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

| Поле | Тип | Описание |
|---|---|---|
| `success` | boolean | Всегда `true` при успехе. |
| `data` | object | Объект со списком задач в `items`. |

Секрет подписи в ответе отсутствует.

Поля объекта `data`:

| Поле | Тип | Описание |
|---|---|---|
| `items` | array | Все неудалённые задачи, максимум 20 |

Поля каждой задачи в `data.items`:

| Поле | Тип | Описание |
|---|---|---|
| `id` | string | Идентификатор задачи |
| `serverId` | string | Идентификатор сервера |
| `label` | string | Подпись задачи |
| `cronExpr` | string | Пять полей cron |
| `timezone` | string | Часовой пояс расписания |
| `path` | string | Путь и необязательная query-строка |
| `enabled` | boolean | Включены ли плановые запуски |
| `nextScheduledFor` | string | Следующее плановое вхождение, UTC ISO-8601 |
| `scheduleRevision` | integer | Ревизия расписания |
| `availableSince` | string | Начало текущего периода расписания, UTC ISO-8601 |
| `createdAt` | string | Время создания, UTC ISO-8601 |
| `updatedAt` | string | Время последнего изменения, UTC ISO-8601 |
| `latestRuns` | array | До 5 последних запусков; поля каждого — в [журнале](./runs.md) |

## Ошибки

| HTTP | Код | Причина |
|---|---|---|
| 401 | `MISSING_API_KEY` | Не передан ключ |
| 403 | `SERVER_ROLE_FORBIDDEN` | Роль участника команды не допускает это действие |
| 404 | `NOT_FOUND` | Сервер не найден или недоступен вызывающему |

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

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

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

- [Создать задачу](./create.md)
- [Заменить настройки задачи](./update.md)
- [Журнал запусков](./runs.md)