GET Statusseiten und Einladungen auflisten
/api/v1/status-pages
Authentifizierte Seitenverwaltung mit aktiver Sitzung, Eigentums-, Seitenrollen- und CSRF-Prüfung. Quellen, Mitglieder, Domains, Versandregeln und die Rücknahme der ganzen Seite benötigen den Besitzer. Redakteure speichern Entwürfe; Herausgeber veröffentlichen freigegebene Inhalte. version erkennt parallele Änderungen. Veröffentlichung und Rücknahme sind erst nach Bestätigung der passenden Veröffentlichungsfassung durch die öffentliche Auslieferung abgeschlossen.
Auf dieser Seite
Zugriff und Rechte
Authentifizierte Seitenverwaltung mit aktiver Sitzung, Eigentums-, Seitenrollen- und CSRF-Prüfung. Quellen, Mitglieder, Domains, Versandregeln und die Rücknahme der ganzen Seite benötigen den Besitzer. Redakteure speichern Entwürfe; Herausgeber veröffentlichen freigegebene Inhalte. version erkennt parallele Änderungen. Veröffentlichung und Rücknahme sind erst nach Bestätigung der passenden Veröffentlichungsfassung durch die öffentliche Auslieferung abgeschlossen.
Browsersitzung: Cookie __Host-mb_session.
Maschinen-Verwaltungszugang in Authorization: Bearer. Beachten Sie die von der Operation benötigten Berechtigungen (Scopes).
Parameter und Header
| Feld | Position | Typ und Grenzen | Erforderlich | Bedeutung |
|---|---|---|---|---|
| table | URL-Parameter | string; {"enum":["1"]} | Nein | Für eine gefilterte Cursor-Seite auf 1 setzen; ohne Tabellenparameter bleibt die ursprüngliche Antwort erhalten. |
| q | URL-Parameter | string; {"maxLength":128} | Nein | Suche nach wörtlichem Text ohne Beachtung der Groß-/Kleinschreibung in den dokumentierten Textfeldern, vor dem Seitenlimit. |
| limit | URL-Parameter | integer; {"default":50,"maximum":100,"minimum":1} | Nein | Seitengröße 1–100, standardmäßig 50. Eine Folgeseite besteht nur bei einer weiteren passenden Zeile. |
| cursor | URL-Parameter | string; {"maxLength":4096} | Nein | Opaker next_cursor der vorherigen Seite. Ressource, Konto, Filter, Sortierung und Limit beibehalten; Listen-Cursor verfallen nach 15 Minuten. |
| sort | URL-Parameter | string; {"enum":["newest","oldest","name_asc","name_desc"]} | Nein | Stabile Sortierung mit der Datensatz-ID bei Gleichstand: newest, oldest, name_asc oder name_desc. |
| role | URL-Parameter | string | Nein | Exakter Feldfilter; Parameter für alle Werte weglassen. |
| delivery | URL-Parameter | string | Nein | Exakter Feldfilter; Parameter für alle Werte weglassen. |
| counts_only | URL-Parameter | string; {"enum":["1"]} | Nein | Liefert Anzahlen für den angegebenen Filter statt Tabellenzeilen. Suche und weitere Filter gelten; die eigene Auswahl, Sortierung und Pagination beeinflussen die Zählung nicht. |
| count_filter | URL-Parameter | string; {"enum":["role","delivery"]} | Nein | Deklarierter Tabellenfilter für die Zählung. Erfordert counts_only=1. |
| snapshot | URL-Parameter | string; {"format":"date-time"} | Nein | Optionaler Snapshot der zugehörigen Tabellenseite. |
Anfragekörper
Kein Anfragekörper.
Antworten
application/json
| Feld | Typ und Grenzen | Erforderlich | Bedeutung |
|---|---|---|---|
| $ | object | object | Ja | — |
| $ (anyOf 1) | object | Nein | — |
| $ (anyOf 1).limits | object; {"additionalProperties":true} | Ja | — |
| $ (anyOf 1).pages | array<object; {"additionalProperties":true}> | Ja | — |
| $ (anyOf 1).pages[] | object; {"additionalProperties":true} | Ja | — |
| $ (anyOf 1).limit | integer; {"maximum":100,"minimum":1} | Nein | — |
| $ (anyOf 1).next_cursor | string | Nein | Cursor zur nächsten passenden Seite; leer, wenn keine Folgeseite besteht. |
| $ (anyOf 1).snapshot | string; {"format":"date-time"} | Nein | An den Cursor gebundener UTC-Snapshot; später angelegte Zeilen gelangen nicht in diese Seitenfolge. |
| $ (anyOf 2) | object | Nein | — |
| $ (anyOf 2).filter_counts | TableFilterCounts | Ja | — |
| $ (anyOf 2).filter_counts.field | string | Ja | — |
| $ (anyOf 2).filter_counts.total | integer; {"minimum":0} | Ja | — |
| $ (anyOf 2).filter_counts.values | object | Ja | — |
| $ (anyOf 2).filter_counts.complete | boolean | Ja | — |
| $ (anyOf 2).filter_counts.snapshot | string; {"format":"date-time"} | Ja | — |
| $ (anyOf 2).filter_counts.counted_at | string; {"format":"date-time"} | Ja | — |
| Stabile Fehlercodes |
|---|
| status_page_operation |
application/problem+json
| Feld | Typ und Grenzen | Erforderlich | Bedeutung |
|---|---|---|---|
| $ | Problem | Ja | — |
| $.code | string | Ja | Stabiler maschinenlesbarer Fehlercode |
| $.detail | string | Ja | Kurze lokalisierte Erklärung ohne interne Fehlerdaten |
| $.instance | string | Ja | Einmalige relative Kennung /api/v1/requests/{request_id}; keine abrufbare Ressource |
| $.message | string | Ja | Vorübergehend für bestehende Clients gleich detail |
| $.message_key | string | Ja | Stabiler Übersetzungsschlüssel für einen Sprachwechsel der Anzeige ohne neue Anfrage |
| $.message_params | object; {"additionalProperties":true} | Ja | Benannte, sicher ausgegebene Meldungsparameter; kein beliebiges HTML |
| $.request_id | string; {"pattern":"^[0-9a-f]{32}$"} | Ja | Vom Server erzeugte Diagnosekennung. Enthält kein Logintoken und keine Zugangsdaten. |
| $.status | integer; {"maximum":599,"minimum":400} | Ja | — |
| $.title | string | Ja | Lokalisierte HTTP-Statusbezeichnung |
| $.type | string; {"const":"about:blank"} | Ja | — |
| Stabile Fehlercodes |
|---|
| status_page_operation |
application/problem+json
| Feld | Typ und Grenzen | Erforderlich | Bedeutung |
|---|---|---|---|
| $ | Problem | Ja | — |
| $.code | string | Ja | Stabiler maschinenlesbarer Fehlercode |
| $.detail | string | Ja | Kurze lokalisierte Erklärung ohne interne Fehlerdaten |
| $.instance | string | Ja | Einmalige relative Kennung /api/v1/requests/{request_id}; keine abrufbare Ressource |
| $.message | string | Ja | Vorübergehend für bestehende Clients gleich detail |
| $.message_key | string | Ja | Stabiler Übersetzungsschlüssel für einen Sprachwechsel der Anzeige ohne neue Anfrage |
| $.message_params | object; {"additionalProperties":true} | Ja | Benannte, sicher ausgegebene Meldungsparameter; kein beliebiges HTML |
| $.request_id | string; {"pattern":"^[0-9a-f]{32}$"} | Ja | Vom Server erzeugte Diagnosekennung. Enthält kein Logintoken und keine Zugangsdaten. |
| $.status | integer; {"maximum":599,"minimum":400} | Ja | — |
| $.title | string | Ja | Lokalisierte HTTP-Statusbezeichnung |
| $.type | string; {"const":"about:blank"} | Ja | — |
| Stabile Fehlercodes |
|---|
| status_page_operation |
application/problem+json
| Feld | Typ und Grenzen | Erforderlich | Bedeutung |
|---|---|---|---|
| $ | Problem | Ja | — |
| $.code | string | Ja | Stabiler maschinenlesbarer Fehlercode |
| $.detail | string | Ja | Kurze lokalisierte Erklärung ohne interne Fehlerdaten |
| $.instance | string | Ja | Einmalige relative Kennung /api/v1/requests/{request_id}; keine abrufbare Ressource |
| $.message | string | Ja | Vorübergehend für bestehende Clients gleich detail |
| $.message_key | string | Ja | Stabiler Übersetzungsschlüssel für einen Sprachwechsel der Anzeige ohne neue Anfrage |
| $.message_params | object; {"additionalProperties":true} | Ja | Benannte, sicher ausgegebene Meldungsparameter; kein beliebiges HTML |
| $.request_id | string; {"pattern":"^[0-9a-f]{32}$"} | Ja | Vom Server erzeugte Diagnosekennung. Enthält kein Logintoken und keine Zugangsdaten. |
| $.status | integer; {"maximum":599,"minimum":400} | Ja | — |
| $.title | string | Ja | Lokalisierte HTTP-Statusbezeichnung |
| $.type | string; {"const":"about:blank"} | Ja | — |
| Stabile Fehlercodes |
|---|
| status_page_operation |
application/problem+json
| Feld | Typ und Grenzen | Erforderlich | Bedeutung |
|---|---|---|---|
| $ | Problem | Ja | — |
| $.code | string | Ja | Stabiler maschinenlesbarer Fehlercode |
| $.detail | string | Ja | Kurze lokalisierte Erklärung ohne interne Fehlerdaten |
| $.instance | string | Ja | Einmalige relative Kennung /api/v1/requests/{request_id}; keine abrufbare Ressource |
| $.message | string | Ja | Vorübergehend für bestehende Clients gleich detail |
| $.message_key | string | Ja | Stabiler Übersetzungsschlüssel für einen Sprachwechsel der Anzeige ohne neue Anfrage |
| $.message_params | object; {"additionalProperties":true} | Ja | Benannte, sicher ausgegebene Meldungsparameter; kein beliebiges HTML |
| $.request_id | string; {"pattern":"^[0-9a-f]{32}$"} | Ja | Vom Server erzeugte Diagnosekennung. Enthält kein Logintoken und keine Zugangsdaten. |
| $.status | integer; {"maximum":599,"minimum":400} | Ja | — |
| $.title | string | Ja | Lokalisierte HTTP-Statusbezeichnung |
| $.type | string; {"const":"about:blank"} | Ja | — |
| Stabile Fehlercodes |
|---|
| status_page_operation |
application/problem+json
| Feld | Typ und Grenzen | Erforderlich | Bedeutung |
|---|---|---|---|
| $ | Problem | Ja | — |
| $.code | string | Ja | Stabiler maschinenlesbarer Fehlercode |
| $.detail | string | Ja | Kurze lokalisierte Erklärung ohne interne Fehlerdaten |
| $.instance | string | Ja | Einmalige relative Kennung /api/v1/requests/{request_id}; keine abrufbare Ressource |
| $.message | string | Ja | Vorübergehend für bestehende Clients gleich detail |
| $.message_key | string | Ja | Stabiler Übersetzungsschlüssel für einen Sprachwechsel der Anzeige ohne neue Anfrage |
| $.message_params | object; {"additionalProperties":true} | Ja | Benannte, sicher ausgegebene Meldungsparameter; kein beliebiges HTML |
| $.request_id | string; {"pattern":"^[0-9a-f]{32}$"} | Ja | Vom Server erzeugte Diagnosekennung. Enthält kein Logintoken und keine Zugangsdaten. |
| $.status | integer; {"maximum":599,"minimum":400} | Ja | — |
| $.title | string | Ja | Lokalisierte HTTP-Statusbezeichnung |
| $.type | string; {"const":"about:blank"} | Ja | — |
| Stabile Fehlercodes |
|---|
| status_page_operation |
| status_pages_disabled |
application/problem+json
| Feld | Typ und Grenzen | Erforderlich | Bedeutung |
|---|---|---|---|
| $ | Problem | Ja | — |
| $.code | string | Ja | Stabiler maschinenlesbarer Fehlercode |
| $.detail | string | Ja | Kurze lokalisierte Erklärung ohne interne Fehlerdaten |
| $.instance | string | Ja | Einmalige relative Kennung /api/v1/requests/{request_id}; keine abrufbare Ressource |
| $.message | string | Ja | Vorübergehend für bestehende Clients gleich detail |
| $.message_key | string | Ja | Stabiler Übersetzungsschlüssel für einen Sprachwechsel der Anzeige ohne neue Anfrage |
| $.message_params | object; {"additionalProperties":true} | Ja | Benannte, sicher ausgegebene Meldungsparameter; kein beliebiges HTML |
| $.request_id | string; {"pattern":"^[0-9a-f]{32}$"} | Ja | Vom Server erzeugte Diagnosekennung. Enthält kein Logintoken und keine Zugangsdaten. |
| $.status | integer; {"maximum":599,"minimum":400} | Ja | — |
| $.title | string | Ja | Lokalisierte HTTP-Statusbezeichnung |
| $.type | string; {"const":"about:blank"} | Ja | — |
Wiederholungen und asynchrone Aufträge
Diese Operation liest oder prüft, ohne eine Ressourcenänderung anzuwenden. Beachten Sie Ratenlimits und Zugangslaufzeiten.
Anfragebeispiele
Ersetzen Sie Demokennungen, Zeitstempel und Platzhalter durch eigene Werte. Behalten Sie bei Wiederholungen Kennungen, Zeit und Inhalt bei. Diese Beispiele führen auf der Seite keine Anfragen aus.
Halten Sie Anmeldelinks, Codes, Cookies und Schlüssel privat. Schreiben Sie sie nicht in Logs und teilen Sie sie nicht in Hilfeanfragen.
curl --request GET --cookie '__Host-mb_session=SESSION; __Host-mb_csrf=CSRF' --header 'X-CSRF-Token: CSRF' 'https://metribeacon.com/api/v1/status-pages'import requests
response = requests.request("GET","https://metribeacon.com/api/v1/status-pages",cookies={"__Host-mb_session":"SESSION","__Host-mb_csrf":"CSRF"},headers={"X-CSRF-Token":"CSRF"})
response.raise_for_status()const response = await fetch("https://metribeacon.com/api/v1/status-pages", {signal:AbortSignal.timeout(10000),method:"GET",credentials:"same-origin",headers:{"Content-Type":"application/json","X-CSRF-Token":csrf}});
if (!response.ok) throw new Error(String(response.status));package main
import (
"fmt"
"net/http"
"time"
)
func main() {
if err := requestStatus(); err != nil { panic("request failed; credentials and response omitted") }
}
func requestStatus() error {
req, err := http.NewRequest("GET", "https://metribeacon.com/api/v1/status-pages", nil)
if err != nil { return err }
req.AddCookie(&http.Cookie{Name:"__Host-mb_session",Value:"SESSION"})
req.AddCookie(&http.Cookie{Name:"__Host-mb_csrf",Value:"CSRF"})
req.Header.Set("X-CSRF-Token","CSRF")
client := &http.Client{Timeout: 10*time.Second}
response, err := client.Do(req)
if err != nil { return err }
defer response.Body.Close()
fmt.Println(response.StatusCode)
return nil
}
Verwandte Anleitungen
- HTTP-API, OAuth und MCP
Finden Sie die Nutzer-API-Endpunkte mit Rechten, Feldern, Beispielen und Antwortformaten.
- POST Private Statusseite erstellen
Authentifizierte Seitenverwaltung mit aktiver Sitzung, Eigentums-, Seitenrollen- und CSRF-Prüfung. Quellen, Mitglieder, Domains, Versandregeln und die Rücknahme der ganzen Seite benötigen den Besitzer. Redakteure speichern Entwürfe; Herausgeber veröffentlichen freigegebene Inhalte. version erkennt parallele Änderungen. Veröffentlichung und Rücknahme sind erst nach Bestätigung der passenden Veröffentlichungsfassung durch die öffentliche Auslieferung abgeschlossen.
- DELETE Öffentliche Auslieferung zurücknehmen oder löschen
Authentifizierte Seitenverwaltung mit aktiver Sitzung, Eigentums-, Seitenrollen- und CSRF-Prüfung. Quellen, Mitglieder, Domains, Versandregeln und die Rücknahme der ganzen Seite benötigen den Besitzer. Redakteure speichern Entwürfe; Herausgeber veröffentlichen freigegebene Inhalte. version erkennt parallele Änderungen. Veröffentlichung und Rücknahme sind erst nach Bestätigung der passenden Veröffentlichungsfassung durch die öffentliche Auslieferung abgeschlossen.
- GET Statusseitenentwurf lesen
Authentifizierte Seitenverwaltung mit aktiver Sitzung, Eigentums-, Seitenrollen- und CSRF-Prüfung. Quellen, Mitglieder, Domains, Versandregeln und die Rücknahme der ganzen Seite benötigen den Besitzer. Redakteure speichern Entwürfe; Herausgeber veröffentlichen freigegebene Inhalte. version erkennt parallele Änderungen. Veröffentlichung und Rücknahme sind erst nach Bestätigung der passenden Veröffentlichungsfassung durch die öffentliche Auslieferung abgeschlossen.