Updates Portal API
Das Updates-Portal stellt eine kleine öffentliche JSON-API bereit, damit du den Status abfragen, Changelog-Einträge importieren, die Roadmap verfolgen und bekannte Probleme über deine eigenen Systeme prüfen kannst. Keine Authentifizierung erforderlich. Die API liefert nur den englischen Text aus; ein Sprachpräfix im Pfad wird ignoriert.
Basis-URL
https://updates.foura.ai
Service-Status
GET /api/v1/status
Gibt den aktuellen Betriebsstatus aller FourA-Dienste sowie aktive und kürzliche Vorfälle zurück. Serverseitig für 15 Sekunden zwischengespeichert, daher liefert häufigeres Polling denselben Payload.
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 }
]
}
| Feld der obersten Ebene | Typ | Beschreibung |
|---|---|---|
overall |
string | operational, wenn jeder Dienst fehlerfrei ist, andernfalls einer der Servicestatus-Werte |
updated_at |
string | Zeitpunkt, zu dem die Statusdaten generiert wurden, ISO 8601 mit einem Z-Suffix |
services |
array | Ein Eintrag pro überwachtem Dienst mit slug, name, description, aktuellem status und daily-Verlauf (bis zu 90 Tage) |
active_incidents |
array | Aktuell offene Incidents |
recent_incidents |
array | Gelöste Incidents der letzten 14 Tage, jeweils mit id, service_slug, service_name, impact, title, status, started_at, resolved_at und duration_seconds |
Service-status-Werte: operational, degraded, partial_outage, major_outage, maintenance. Ein daily-Eintrag kann auch no_data lauten, für einen Tag ohne erfasste Daten. internal_degraded_minutes zählt Zeiten ohne Auswirkungen auf Kunden.
Incident-impact-Werte: minor (eingeschränkte Leistung), major (teilweiser Ausfall), critical (Serviceausfall).
Polling-Muster
Nutze diesen Endpoint, um den FourA-Status in dein eigenes Dashboard oder Paging-System einzubinden.
Wenn die Statusdaten nicht abgerufen werden können, antwortet der Endpoint mit 502 und {"error": "Monitor unreachable"}. Behandle dies als unbekannten statt als fehlerhaften Status und versuche es beim nächsten Abruf erneut.
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
Der Legacy-GET /api/status gibt 410 Gone zurück und verweist Aufrufer hierher.
Changelog
GET /api/changelog
Gibt veröffentlichte Changelog-Einträge in umgekehrter chronologischer Reihenfolge zurück.
curl "https://updates.foura.ai/api/changelog?limit=20"
Query-Parameter:
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
page |
integer | 1 | 1-basierte Seitennummer |
limit |
integer | 20 | Einträge pro Seite (max. 50) |
category |
string | - | Filtern nach new, improved oder 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
}
| Feld | Typ | Beschreibung |
|---|---|---|
id |
integer | Eintrags-ID |
title |
string | Eintragstitel |
body |
string | Markdown-Body |
category |
string | new, improved oder fixed |
tags |
string | Ein JSON-Array, das als String codiert ist. Parse es vor der Verwendung: json.loads(entry["tags"]). |
published |
integer | Hier immer 1. Der Endpoint liefert nur veröffentlichte Einträge zurück. |
published_at |
string | ISO 8601 mit einem Z-Suffix |
created_at |
string | YYYY-MM-DD HH:MM:SS, UTC, ohne Zonenbezeichner |
updated_at |
string | Gleiches Format wie created_at |
Die beiden Zeitstempelformate unterscheiden sich bewusst: published_at ist das redaktionelle Datum und enthält eine Zeitzone, während created_at und updated_at Speicher-Zeitstempel sind. Beide sind UTC. Ein Parser, der dasselbe Format für alle drei erwartet, schlägt bei den anderen beiden fehl.
RSS
Das vollständige Changelog (die 30 neuesten Einträge) wird auch als RSS veröffentlicht unter:
https://updates.foura.ai/rss
Abonniere in Feedly, Miniflux, Thunderbird oder einem beliebigen Reader. Der Feed-Body entspricht dem Changelog-Body, inklusive Markdown gerendert als HTML.
Roadmap
GET /api/roadmap
Gibt jedes veröffentlichte Roadmap-Element zurück, sortiert nach Anzahl der Stimmen und danach nach Erstellungszeitpunkt.
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-Werte für Einträge: planned, in_progress, done, cancelled. Das Board unter updates.foura.ai/roadmap stellt drei Spalten dar. Ein Eintrag mit dem Status cancelled erreicht dich also über diesen Endpoint, erscheint aber nie auf der Seite.
category ist ein Slug in Kleinbuchstaben, nicht das Label, das die Seite anzeigt. Aktuell genutzte Slugs: api, infrastructure, developer-experience, dashboard, billing, analytics, authentication. Betrachte die Liste als offen, da ein neues Item einen neuen Slug einführen kann.
target_date ist Freitext ("Q3 2026"), kein Datum. completed_at ist null, bis ein Item veröffentlicht wird, danach ISO 8601 mit einem Z-Suffix (2026-09-01T10:15:30.000Z), genau wie das published_at eines Changelog-Eintrags. created_at verwendet YYYY-MM-DD HH:MM:SS in UTC. Die beiden Formate unterscheiden sich innerhalb desselben Objekts, parse daher jedes Feld separat.
Abstimmen
POST /api/roadmap/:id/vote
Schaltet eine Stimme für ein einzelnes Roadmap-Item um. Stimmen sind anonym und an die IP des Aufrufers sowie die ersten 50 Zeichen seines User-Agent gebunden. Ein erneuter Aufruf entfernt die Stimme. Ein unbekanntes oder unveröffentlichtes Item gibt 404 {"error": "Not found"} zurück.
curl -X POST https://updates.foura.ai/api/roadmap/12/vote
{ "votes": 24, "voted": true }
voted meldet den Status nach dem Aufruf: true, wenn dein Vote hinzugefügt wurde, false, wenn er entfernt wurde.
Die Roadmap-Endpoints, GET /api/roadmap und dieser hier, sind auf 30 Requests pro Minute und Quell-IP limitiert. Darüber lautet die Antwort HTTP 429 mit {"error": "Too many votes, slow down"}. Jede Roadmap-Response enthält X-RateLimit-Limit, X-RateLimit-Remaining und X-RateLimit-Reset (ein Unix-Timestamp in Sekunden), damit du drosseln kannst, bevor du das Limit erreichst.
Bekannte Probleme
GET /api/issues
Gibt vom FourA-Support erfasste Issues zurück.
curl "https://updates.foura.ai/api/issues?tab=open"
Query-Parameter:
| Parameter | Type | Default | Description |
|---|---|---|---|
tab |
string | open |
open für aktive Issues, resolved für gelöste/geschlossene |
{
"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"
}
]
}
| Feld | Typ | Beschreibung |
|---|---|---|
id |
integer | Issue-ID |
title |
string | Kurze Zusammenfassung |
body |
string | Markdown-Beschreibung |
severity |
string | low, medium, high oder critical |
status |
string | open, investigating, resolved oder closed |
service_id |
integer or null | Numerische ID des betroffenen Dienstes. null, wenn das Issue keinem Dienst zugeordnet ist. |
service_name |
string or null | Der Anzeigename des Dienstes, bereits aufgelöst. Lies diesen Wert, anstatt service_id selbst zuzuordnen. |
resolution |
string | Wie der Fehler behoben wurde. Leere Zeichenkette, solange das Issue offen ist. |
opened_at |
string | ISO 8601 mit dem Suffix Z |
resolved_at |
string or null | ISO 8601 mit dem Suffix Z, null solange offen |
service_id ist ein numerischer Fremdschlüssel, nicht der Slug auf der Statusseite. Ordne Issues über service_name Diensten zu.
Die Issue-Payload ist eine feste Spaltenliste und enthält keinen Änderungszeitstempel. Sortiere oder altere ein Issue nach opened_at und resolved_at. Von den drei öffentlichen Sammlungen geben nur Changelog-Einträge updated_at zurück. Roadmap-Einträge geben zusätzlich created_at zurück, und Issues geben keines von beiden zurück.
Der Tab resolved gibt die 30 zuletzt behobenen Issues zurück und stoppt dort. Der Tab open gibt alle zurück.
Hinweise
- Alle Endpoints sind öffentlich und erfordern keinen API-Key. Die Roadmap-Endpoints sind auf 30 Requests pro Minute und Quell-IP beschränkt; die anderen haben derzeit kein eigenes Rate Limit. Rufe den Status daher nicht häufiger ab, als es der 15-Sekunden-Cache rechtfertigt.
- Antworten sind JSON über HTTPS. Roadmap und Issues akzeptieren keine Paging-Parameter. Die einzige Begrenzung ist
?tab=resolvedbei Issues, was 30 Zeilen zurückgibt. - Für Freitext- oder reine HTML-Versionen des Changelogs nutze den Feed
/rssanstelle von/api/changelog.
Verwandte Themen
- Dienststatus: Lies dieselben Daten im Browser
- Changelog: Durchsuche Einträge mit Filtern und Paginierung
- Roadmap: Stimme über Einträge in der UI ab
- Bekannte Probleme: Lies offene und behobene Issues
- Updates-Portal: Bereichsübersicht