API портала обновлений
Портал обновлений предоставляет небольшой публичный JSON API, с помощью которого вы можете опрашивать статус, загружать записи changelog, отслеживать roadmap и проверять известные проблемы из своих систем. Аутентификация не требуется. API возвращает текст только на английском языке; языковой префикс в пути игнорируется.
Базовый URL
https://updates.foura.ai
Статус сервисов
GET /api/v1/status
Возвращает текущий рабочий статус каждого сервиса FourA, а также активные и недавние инциденты. Кэшируется на стороне сервера на 15 секунд, поэтому более частый опрос возвращает тот же результат.
curl https://updates.foura.ai/api/v1/status
{
"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"}. Считайте такой статус неизвестным, а не сбойным, и повторите запрос при следующем цикле опроса.
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
Возвращает опубликованные записи журнала изменений в обратном хронологическом порядке.
curl "https://updates.foura.ai/api/changelog?limit=20"
Параметры запроса:
| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
page |
integer | 1 | Номер страницы (индексация с 1) |
limit |
integer | 20 | Количество записей на странице (максимум 50) |
category |
string | - | Фильтр по new, improved или fixed |
{
"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
Возвращает все опубликованные пункты дорожной карты, отсортированные по количеству голосов, затем по времени создания.
curl https://updates.foura.ai/api/roadmap
{
"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 отображает три колонки, поэтому элемент со значением 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"}.
curl -X POST https://updates.foura.ai/api/roadmap/12/vote
{ "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.
curl "https://updates.foura.ai/api/issues?tab=open"
Параметры запроса:
| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
tab |
string | open |
open для активных проблем, resolved для решенных/закрытых |
{
"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вместо/api/changelog.
Связанные ресурсы
- Service Status: просмотр тех же данных в браузере
- Changelog: просмотр записей с фильтрами и пагинацией
- Roadmap: голосование за пункты плана в UI
- Known Issues: просмотр открытых и решенных проблем
- Updates Portal: обзор раздела