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=resolved bei Issues, was 30 Zeilen zurückgibt.
  • Für Freitext- oder reine HTML-Versionen des Changelogs nutze den Feed /rss anstelle von /api/changelog.
Aktualisiert: 5. November 2026