# Updates Portal API

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

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.

```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 }
  ]
}
```

| 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.

```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
```

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.

```bash
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` |

```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
}
```

| 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.

```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`-Werte für Einträge: `planned`, `in_progress`, `done`, `cancelled`. Das Board unter [updates.foura.ai/roadmap](https://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.

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

```json
{ "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.

```bash
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 |

```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"
    }
  ]
}
```

| 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`](https://updates.foura.ai/rss) anstelle von `/api/changelog`.

## Verwandte Themen

- [Dienststatus](https://foura.ai/docs/updates-portal/status): Lies dieselben Daten im Browser
- [Changelog](https://foura.ai/docs/updates-portal/changelog): Durchsuche Einträge mit Filtern und Paginierung
- [Roadmap](https://foura.ai/docs/updates-portal/roadmap): Stimme über Einträge in der UI ab
- [Bekannte Probleme](https://foura.ai/docs/updates-portal/issues): Lies offene und behobene Issues
- [Updates-Portal](https://foura.ai/docs/updates-portal/overview): Bereichsübersicht
