# API портала обновлений

> URL: https://foura.ai/ru/docs/updates-portal/api
> Updated: 2026-11-05
> Index: https://foura.ai/llms.txt

Портал обновлений предоставляет небольшой публичный JSON API, с помощью которого вы можете опрашивать статус, загружать записи changelog, отслеживать roadmap и проверять известные проблемы из своих систем. Аутентификация не требуется. API возвращает текст только на английском языке; языковой префикс в пути игнорируется.

## Базовый URL

```
https://updates.foura.ai
```

## Статус сервисов

`GET /api/v1/status`

Возвращает текущий рабочий статус каждого сервиса FourA, а также активные и недавние инциденты. Кэшируется на стороне сервера на 15 секунд, поэтому более частый опрос возвращает тот же результат.

```bash
curl https://updates.foura.ai/api/v1/status
```

```json
{
  "overall": "operational",
  "updated_at": "2026-05-19T12:00:00.000Z",
  "services": [
    {
      "slug": "api-gateway",
      "name": "API Gateway",
      "description": "...",
      "status": "operational",
      "daily": [
        { "date": "2026-05-19", "status": "operational", "major_outage_minutes": 0, "partial_outage_minutes": 0, "degraded_minutes": 0, "internal_degraded_minutes": 0 }
      ]
    }
  ],
  "active_incidents": [],
  "recent_incidents": [
    { "id": 12, "service_slug": "api-gateway", "service_name": "API Gateway", "impact": "minor", "title": "API Gateway: Degraded Performance", "status": "resolved", "started_at": "...", "resolved_at": "...", "duration_seconds": 30 }
  ]
}
```

| Поле верхнего уровня | Тип | Описание |
|-----------------|------|-------------|
| `overall` | string | `operational`, если все сервисы работают штатно, иначе одно из значений статуса сервиса |
| `updated_at` | string | Время формирования данных о статусе, ISO 8601 с суффиксом `Z` |
| `services` | array | По одной записи на каждый отслеживаемый сервис с `slug`, `name`, `description`, текущим `status` и историей `daily` (до 90 дней) |
| `active_incidents` | array | Открытые в данный момент инциденты |
| `recent_incidents` | array | Решенные инциденты за последние 14 дней, каждый с `id`, `service_slug`, `service_name`, `impact`, `title`, `status`, `started_at`, `resolved_at` и `duration_seconds` |

Значения `status` сервиса: `operational`, `degraded`, `partial_outage`, `major_outage`, `maintenance`. Запись `daily` также может содержать `no_data` для дня без записанных данных. `internal_degraded_minutes` учитывает время без влияния на клиентов.

Значения `impact` инцидента: `minor` (снижение производительности), `major` (частичный сбой), `critical` (сбой в работе сервиса).

### Паттерн опроса

Используйте этот endpoint для передачи статуса FourA в собственный дашборд или систему оповещений.

Если данные о статусе не удается получить, endpoint возвращает `502` с `{"error": "Monitor unreachable"}`. Считайте такой статус неизвестным, а не сбойным, и повторите запрос при следующем цикле опроса.

```python
import requests

def check_foura():
    r = requests.get("https://updates.foura.ai/api/v1/status", timeout=5)
    r.raise_for_status()   # raises on the 502 "Monitor unreachable" answer: retry next poll
    data = r.json()
    if data["overall"] != "operational":
        # Page on-call, post to Slack, flip a feature flag, etc.
        for svc in data["services"]:
            if svc["status"] != "operational":
                print(f"{svc['name']}: {svc['status']}")
    return data
```

Устаревший `GET /api/status` возвращает `410 Gone` и перенаправляет вызывающих сюда.

## История изменений

`GET /api/changelog`

Возвращает опубликованные записи журнала изменений в обратном хронологическом порядке.

```bash
curl "https://updates.foura.ai/api/changelog?limit=20"
```

Параметры запроса:

| Параметр | Тип | По умолчанию | Описание |
|-----------|------|---------|-------------|
| `page` | integer | 1 | Номер страницы (индексация с 1) |
| `limit` | integer | 20 | Количество записей на странице (максимум 50) |
| `category` | string | - | Фильтр по `new`, `improved` или `fixed` |

```json
{
  "entries": [
    {
      "id": 42,
      "title": "...",
      "body": "Markdown body",
      "category": "new",
      "tags": "[\"api\",\"dashboard\"]",
      "published": 1,
      "published_at": "2026-05-19T12:00:00Z",
      "created_at": "2026-05-19 11:42:08",
      "updated_at": "2026-05-19 11:44:31"
    }
  ],
  "total": 137,
  "page": 1,
  "limit": 20
}
```

| Поле | Тип | Описание |
|-------|------|-------------|
| `id` | integer | ID записи |
| `title` | string | Заголовок записи |
| `body` | string | Тело в формате Markdown |
| `category` | string | `new`, `improved` или `fixed` |
| `tags` | string | Массив JSON, **закодированный как строка**. Распарсите его перед использованием: `json.loads(entry["tags"])`. |
| `published` | integer | Здесь всегда `1`. Этот endpoint возвращает только опубликованные записи. |
| `published_at` | string | ISO 8601 с суффиксом `Z` |
| `created_at` | string | `YYYY-MM-DD HH:MM:SS`, UTC, без указания часового пояса |
| `updated_at` | string | Тот же формат, что и у `created_at` |

Два формата меток времени различаются намеренно: `published_at` представляет собой дату публикации и содержит часовой пояс, тогда как `created_at` и `updated_at` являются метками времени хранилища. Обе в UTC. Парсер, ожидающий одинаковый формат для всех трех, завершится с ошибкой на двух остальных.

### RSS

Полный changelog (30 последних записей) также публикуется в виде RSS по адресу:

```
https://updates.foura.ai/rss
```

Подпишитесь через Feedly, Miniflux, Thunderbird или любой другой ридер. Содержимое фида полностью соответствует тексту changelog, включая markdown, отрендеренный в HTML.

## Дорожная карта

`GET /api/roadmap`

Возвращает все опубликованные пункты дорожной карты, отсортированные по количеству голосов, затем по времени создания.

```bash
curl https://updates.foura.ai/api/roadmap
```

```json
{
  "items": [
    {
      "id": 12,
      "title": "...",
      "description": "...",
      "status": "planned",
      "category": "developer-experience",
      "votes": 23,
      "target_date": "Q3 2026",
      "completed_at": null,
      "created_at": "2026-03-30 09:32:47"
    }
  ]
}
```

Значения `status` элемента: `planned`, `in_progress`, `done`, `cancelled`. Доска на [updates.foura.ai/roadmap](https://updates.foura.ai/roadmap) отображает три колонки, поэтому элемент со значением `cancelled` возвращается через этот endpoint, но никогда не появляется на странице.

`category` представляет собой slug в нижнем регистре, а не отображаемую на странице метку. Используемые сейчас slugs: `api`, `infrastructure`, `developer-experience`, `dashboard`, `billing`, `analytics`, `authentication`. Список не является фиксированным, так как новый элемент может добавить новый slug.

`target_date` содержит произвольный текст (`"Q3 2026"`), а не дату. `completed_at` имеет значение `null` до релиза элемента, после чего принимает формат ISO 8601 с суффиксом `Z` (`2026-09-01T10:15:30.000Z`), аналогично `published_at` в записи changelog. Поле `created_at` использует `YYYY-MM-DD HH:MM:SS` в UTC. Форматы различаются внутри одного объекта, поэтому парсите каждое поле отдельно.

### Голосование

`POST /api/roadmap/:id/vote`

Переключает голос за отдельный элемент roadmap. Голоса анонимны и привязаны к IP вызывающей стороны и первым 50 символам ее User-Agent. Повторный вызов отменяет голос. Неизвестный или неопубликованный элемент возвращает `404 {"error": "Not found"}`.

```bash
curl -X POST https://updates.foura.ai/api/roadmap/12/vote
```

```json
{ "votes": 24, "voted": true }
```

`voted` сообщает состояние после вызова: `true`, если ваш голос был добавлен, `false`, если он был удален.

Endpoints roadmap, `GET /api/roadmap` и этот, ограничены 30 requests в минуту на один исходный IP. При превышении возвращается HTTP `429` с `{"error": "Too many votes, slow down"}`. Каждый response roadmap содержит `X-RateLimit-Limit`, `X-RateLimit-Remaining` и `X-RateLimit-Reset` (Unix timestamp в секундах), чтобы вы могли снизить частоту запросов до достижения лимита.

## Известные проблемы

`GET /api/issues`

Возвращает проблемы, отслеживаемые поддержкой FourA.

```bash
curl "https://updates.foura.ai/api/issues?tab=open"
```

Параметры запроса:

| Параметр | Тип | По умолчанию | Описание |
|-----------|------|---------|-------------|
| `tab` | string | `open` | `open` для активных проблем, `resolved` для решенных/закрытых |

```json
{
  "issues": [
    {
      "id": 5,
      "title": "...",
      "body": "Markdown description",
      "severity": "medium",
      "status": "investigating",
      "service_id": 3,
      "resolution": "",
      "opened_at": "2026-05-18T09:00:00Z",
      "resolved_at": null,
      "service_name": "API"
    }
  ]
}
```

| Поле | Тип | Описание |
|-------|------|-------------|
| `id` | integer | ID инцидента |
| `title` | string | Краткая сводка |
| `body` | string | Описание в формате Markdown |
| `severity` | string | `low`, `medium`, `high` или `critical` |
| `status` | string | `open`, `investigating`, `resolved` или `closed` |
| `service_id` | integer or null | Числовой ID затронутого сервиса. `null`, если проблема не привязана к конкретному сервису. |
| `service_name` | string or null | Отображаемое имя сервиса, определенное автоматически. Используйте его вместо самостоятельного сопоставления `service_id`. |
| `resolution` | string | Способ решения. Пустая строка, пока проблема открыта. |
| `opened_at` | string | ISO 8601 с суффиксом `Z` |
| `resolved_at` | string or null | ISO 8601 с суффиксом `Z`, `null` пока проблема открыта |

`service_id` является числовым внешним ключом, а не слагом, отображаемым на странице статуса. Сопоставляйте проблемы с сервисами по `service_name`.

Полезная нагрузка проблемы содержит фиксированный список полей и не включает метку времени изменения. Сортируйте или фильтруйте проблемы по возрасту с помощью `opened_at` и `resolved_at`. Из трех публичных коллекций только записи changelog возвращают `updated_at`. Элементы roadmap также возвращают `created_at`, а проблемы не возвращают ни одно из этих полей.

Вкладка `resolved` возвращает 30 последних решенных проблем и на этом останавливается. Вкладка `open` возвращает их все.

## Примечания

- Все endpoint являются публичными и не требуют API key. Для endpoint roadmap действует rate limit в 30 requests в минуту на исходный IP; остальные сейчас не имеют собственного rate limit, поэтому опрашивайте статус не чаще, чем того требует его 15-секундный кэш.
- Ответы передаются в формате JSON по HTTPS. Roadmap и проблемы не принимают параметры пагинации. Единственное ограничение касается `?tab=resolved` для проблем, где возвращается 30 строк.
- Для получения версий changelog в виде обычного текста или чистого HTML используйте ленту [`/rss`](https://updates.foura.ai/rss) вместо `/api/changelog`.

## Связанные ресурсы

- [Service Status](https://foura.ai/docs/updates-portal/status): просмотр тех же данных в браузере
- [Changelog](https://foura.ai/docs/updates-portal/changelog): просмотр записей с фильтрами и пагинацией
- [Roadmap](https://foura.ai/docs/updates-portal/roadmap): голосование за пункты плана в UI
- [Known Issues](https://foura.ai/docs/updates-portal/issues): просмотр открытых и решенных проблем
- [Updates Portal](https://foura.ai/docs/updates-portal/overview): обзор раздела
