Deutsch English

Ankündigungen auflisten

GET /api/v1/announcements

Vergangene, laufende und geplante Banner. Für die gerade sichtbaren den active-Filter nutzen.

Erforderliche Berechtigung

announcements.manage Ankündigungen verwalten

Body Parameter (application/json)

Name Format Beschreibung Optional
page integer
per_page integer Wird auf die maximale Seitengröße begrenzt statt abgewiesen.
active boolean Nur Banner, die gerade angezeigt werden.
level

Response (application/json)

200 
{3 Eigenschaften
  "links": {4 Eigenschaften
    "first": "https://status.example.com/api/v1/announcements?page=1",
    "last": "https://status.example.com/api/v1/announcements?page=1",
    "prev": null,
    "next": null
  },
  "meta": {4 Eigenschaften
    "current_page": 1,
    "per_page": 25,
    "total": 1,
    "last_page": 1
  },
  "data": [1 Element
    {10 Eigenschaften
      "id": "01kyhjx7hxggqfaekf2b5sy61x",
      "title": {2 Eigenschaften
        "de": "Wartungsfenster am Sonntag",
        "en": "Maintenance window on Sunday"
      },
      "body": {2 Eigenschaften
        "de": "Zwischen 02:00 und 04:00 Uhr kann es zu kurzen Unterbrechungen kommen.",
        "en": null
      },
      "level": "warning",
      "dismissible": true,
      "starts_at": "2026-07-24T00:00:00Z",
      "ends_at": "2026-07-28T00:00:00Z",
      "is_active": true,
      "created_at": "2026-07-23T10:00:00Z",
      "updated_at": "2026-07-23T10:00:00Z"
    }
  ]
}

cURL

curl -X GET 'https://status.example.com/api/v1/announcements' \
  -H 'Authorization: Bearer fs_YOUR_API_KEY'