Dokumentation / API · Geräte / Änderung der Aufbewahrung prüfen (Konto) POST Änderung der Aufbewahrung prüfen (Konto)/api/v1/account/retention/preview
Ganze rollierende 24-Stunden-Tage, mindestens eins. Wirksam ist das Minimum aus Systemobergrenzen, Eigentümerkonto und Monitorvorgaben. Null bedeutet Vererbung. Verkürzungen sperren abgelaufene Daten sofort und starten die physische Bereinigung; pausierte Bereinigungen zeigen den Grund. Abgelaufene Daten kehren nach Verlängerung oder Zurücksetzen nicht zurück. Vorfälle, Zustellhistorien, Berichte und Sicherheitsprotokolle haben eigene Fristen; externe Kopien bleiben unberührt. Änderungen verlangen eine Browsersitzung des Eigentümers, CSRF und einen aktuellen Stand. Kontovorgaben gehören stets zum angemeldeten Nutzer, auch bei Auswahl eines geteilten Arbeitsbereichs. Mitglieder dürfen die Monitorfristen sehen; nur der Arbeitsbereicheigentümer darf sie ändern. Ist die Funktion nicht verfügbar, antworten Änderungen mit HTTP 503; die Leseantwort zeigt, ob Sie die Einstellung ändern dürfen.
Auf dieser Seite Zugriff und Rechte Parameter und Header Anfragekörper Antworten Wiederholungen und asynchrone Aufträge Anfragebeispiele Verwandte Anleitungen Ganze rollierende 24-Stunden-Tage, mindestens eins. Wirksam ist das Minimum aus Systemobergrenzen, Eigentümerkonto und Monitorvorgaben. Null bedeutet Vererbung. Verkürzungen sperren abgelaufene Daten sofort und starten die physische Bereinigung; pausierte Bereinigungen zeigen den Grund. Abgelaufene Daten kehren nach Verlängerung oder Zurücksetzen nicht zurück. Vorfälle, Zustellhistorien, Berichte und Sicherheitsprotokolle haben eigene Fristen; externe Kopien bleiben unberührt. Änderungen verlangen eine Browsersitzung des Eigentümers, CSRF und einen aktuellen Stand. Kontovorgaben gehören stets zum angemeldeten Nutzer, auch bei Auswahl eines geteilten Arbeitsbereichs. Mitglieder dürfen die Monitorfristen sehen; nur der Arbeitsbereicheigentümer darf sie ändern. Ist die Funktion nicht verfügbar, antworten Änderungen mit HTTP 503; die Leseantwort zeigt, ob Sie die Einstellung ändern dürfen.
Browsersitzung: Cookie __Host-mb_session.
Benötigte Maschinenberechtigungen (Scopes): config:write Senden Sie bei einer Änderung mit Browsersitzung das aktuelle CSRF-Token in X-CSRF-Token zusammen mit dem Same-Site-Cookie. OAuth-Zustimmung verwendet ihr dokumentiertes Formularfeld.
Feld Position Typ und Grenzen Erforderlich Bedeutung Origin Header string; {"format":"uri"} Nein Muss, falls vorhanden, dem kanonischen HTTPS-Origin entsprechen. Sec-Fetch-Site cross-site wird abgewiesen. X-CSRF-Token Header string Nein Wert des Browser-CSRF-Cookies. Bei einem zulässigen Maschinen-Verwaltungszugang nicht erforderlich.
Feld Typ und Grenzen Erforderlich Bedeutung $ RetentionDraft Ja — $.days RetentionDays Nein — $.days.raw integer | null; {"minimum":1,"maximum":7} Nein Originalmesswerte und Zustände. $.days.minute integer | null; {"minimum":1,"maximum":30} Nein Minutenwerte. $.days.quarter_hour integer | null; {"minimum":1,"maximum":365} Nein Viertelstundenwerte. $.days.hour integer | null; {"minimum":1,"maximum":1095} Nein Stundenwerte. $.days.text integer | null; {"minimum":1,"maximum":7} Nein Originaltexte und zugehörige Laufdetails. $.revision string; {"pattern":"^[0-9]+:[0-9]+$"} Ja Konto- und Monitorrevision aus dem aktuellen GET; eine veraltete Revision liefert HTTP 409. $.preview_id string; {"format":"uuid"} Nein Unverbrauchte Vorschau für denselben Nutzer, Bereich, dieselbe Revision und den normalisierten Entwurf; zehn Minuten gültig. Für PUT erforderlich. $.confirm_deletion boolean Nein Angezeigte Datenlöschung ausdrücklich bestätigen, wenn die Vorschau eine Frist verkürzt.
200 · Erfolgreiche Antwort. Header Typ und Grenzen Bedeutung Cache-Control string; {"pattern":"(?:^|,\\s*)no-store(?:,|$)"} Private API-Antworten verbieten Speicherung. Öffentliche OAuth-Metadaten werden 300 Sekunden gecacht; Livestreams verbieten zusätzlich Transformation. Content-Language string; {"enum":["en","de"]} Sprache lesbarer Antworttexte aus Accept-Language oder der dokumentierten Browserpräferenz. Technische Codes und Kennungen bleiben stabil. Referrer-Policy JSON; {"enum":["strict-origin-when-cross-origin","no-referrer"]} Standard-Referrerpolicy ist strict-origin-when-cross-origin. Anbieterloginantworten verwenden no-referrer zum Schutz der Loginparameter. Vary string Antworten variieren nach Accept-Language; browsergerenderte Antworten können zusätzlich nach Präferenzcookie variieren. X-Content-Type-Options JSON; {"const":"nosniff"} Der Browser muss den angegebenen Inhaltstyp verwenden. X-Frame-Options JSON; {"const":"DENY"} Die Antwort darf nicht in einem Frame eingebettet werden. X-Request-ID string Vom Server erzeugte Anfragekennung. Bei Fehlermeldungen mitgeben; eingehende Werte werden nicht als vertrauenswürdig übernommen.
application/json
Feld Typ und Grenzen Erforderlich Bedeutung $ RetentionPreview Ja — $.id string; {"format":"uuid"} Ja — $.revision string Ja — $.expires_at string; {"format":"date-time"} Ja — $.shortening boolean Ja — $.affected_monitors integer; {"minimum":0} Ja — $.changes array<object; {"additionalProperties":false}>; {"maxItems":250} Ja — $.changes[] object; {"additionalProperties":false} Ja — $.changes[].device_id string; {"format":"uuid"} Ja — $.changes[].name string Ja — $.changes[].kind string; {"enum":["raw","minute","quarter_hour","hour","text"]} Ja — $.changes[].previous_days integer; {"minimum":1,"maximum":1095} Ja — $.changes[].days integer; {"minimum":1,"maximum":1095} Ja — $.changes[].expired_before string; {"format":"date-time"} Ja — $.truncated boolean Ja —
json Beispiel kopieren
{
"id" : "00000000-0000-4000-8000-000000000001" ,
"revision" : "0:0" ,
"expires_at" : "2026-10-02T12:10:00Z" ,
"shortening" : true ,
"affected_monitors" : 1,
"changes" : [
{
"device_id" : "00000000-0000-4000-8000-000000000002" ,
"name" : "Demo monitor" ,
"kind" : "raw" ,
"previous_days" : 7,
"days" : 3,
"expired_before" : "2026-09-29T12:00:00Z"
}
],
"truncated" : false
} 401 · Anfrage abgewiesen. Prüfen Sie den stabilen Fehlercode. Stabile Fehlercodes invalid_credential unauthorized authentication_required
Header Typ und Grenzen Bedeutung Cache-Control string; {"pattern":"(?:^|,\\s*)no-store(?:,|$)"} Private API-Antworten verbieten Speicherung. Öffentliche OAuth-Metadaten werden 300 Sekunden gecacht; Livestreams verbieten zusätzlich Transformation. Content-Language string; {"enum":["en","de"]} Sprache lesbarer Antworttexte aus Accept-Language oder der dokumentierten Browserpräferenz. Technische Codes und Kennungen bleiben stabil. Referrer-Policy JSON; {"enum":["strict-origin-when-cross-origin","no-referrer"]} Standard-Referrerpolicy ist strict-origin-when-cross-origin. Anbieterloginantworten verwenden no-referrer zum Schutz der Loginparameter. Vary string Antworten variieren nach Accept-Language; browsergerenderte Antworten können zusätzlich nach Präferenzcookie variieren. X-Content-Type-Options JSON; {"const":"nosniff"} Der Browser muss den angegebenen Inhaltstyp verwenden. X-Frame-Options JSON; {"const":"DENY"} Die Antwort darf nicht in einem Frame eingebettet werden. X-Request-ID string Vom Server erzeugte Anfragekennung. Bei Fehlermeldungen mitgeben; eingehende Werte werden nicht als vertrauenswürdig übernommen.
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 —
json Beispiel kopieren
{
"code" : "demo" ,
"detail" : "Demo error detail; inspect the documented code." ,
"instance" : "demo" ,
"message" : "Demo error detail; inspect the documented code." ,
"message_key" : "errors.requestFailed" ,
"message_params" : {},
"request_id" : "00000000000000000000000000000000" ,
"status" : 401,
"title" : "Demo error" ,
"type" : "about:blank"
} 403 · Anfrage abgewiesen. Prüfen Sie den stabilen Fehlercode. Stabile Fehlercodes csrf insufficient_scope invalid_origin owner_required
Header Typ und Grenzen Bedeutung Cache-Control string; {"pattern":"(?:^|,\\s*)no-store(?:,|$)"} Private API-Antworten verbieten Speicherung. Öffentliche OAuth-Metadaten werden 300 Sekunden gecacht; Livestreams verbieten zusätzlich Transformation. Content-Language string; {"enum":["en","de"]} Sprache lesbarer Antworttexte aus Accept-Language oder der dokumentierten Browserpräferenz. Technische Codes und Kennungen bleiben stabil. Referrer-Policy JSON; {"enum":["strict-origin-when-cross-origin","no-referrer"]} Standard-Referrerpolicy ist strict-origin-when-cross-origin. Anbieterloginantworten verwenden no-referrer zum Schutz der Loginparameter. Vary string Antworten variieren nach Accept-Language; browsergerenderte Antworten können zusätzlich nach Präferenzcookie variieren. X-Content-Type-Options JSON; {"const":"nosniff"} Der Browser muss den angegebenen Inhaltstyp verwenden. X-Frame-Options JSON; {"const":"DENY"} Die Antwort darf nicht in einem Frame eingebettet werden. X-Request-ID string Vom Server erzeugte Anfragekennung. Bei Fehlermeldungen mitgeben; eingehende Werte werden nicht als vertrauenswürdig übernommen.
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 —
json Beispiel kopieren
{
"code" : "demo" ,
"detail" : "Demo error detail; inspect the documented code." ,
"instance" : "demo" ,
"message" : "Demo error detail; inspect the documented code." ,
"message_key" : "errors.requestFailed" ,
"message_params" : {},
"request_id" : "00000000000000000000000000000000" ,
"status" : 403,
"title" : "Demo error" ,
"type" : "about:blank"
} 404 · Anfrage abgewiesen. Prüfen Sie den stabilen Fehlercode. Stabile Fehlercodes not_found
Header Typ und Grenzen Bedeutung Cache-Control string; {"pattern":"(?:^|,\\s*)no-store(?:,|$)"} Private API-Antworten verbieten Speicherung. Öffentliche OAuth-Metadaten werden 300 Sekunden gecacht; Livestreams verbieten zusätzlich Transformation. Content-Language string; {"enum":["en","de"]} Sprache lesbarer Antworttexte aus Accept-Language oder der dokumentierten Browserpräferenz. Technische Codes und Kennungen bleiben stabil. Referrer-Policy JSON; {"enum":["strict-origin-when-cross-origin","no-referrer"]} Standard-Referrerpolicy ist strict-origin-when-cross-origin. Anbieterloginantworten verwenden no-referrer zum Schutz der Loginparameter. Vary string Antworten variieren nach Accept-Language; browsergerenderte Antworten können zusätzlich nach Präferenzcookie variieren. X-Content-Type-Options JSON; {"const":"nosniff"} Der Browser muss den angegebenen Inhaltstyp verwenden. X-Frame-Options JSON; {"const":"DENY"} Die Antwort darf nicht in einem Frame eingebettet werden. X-Request-ID string Vom Server erzeugte Anfragekennung. Bei Fehlermeldungen mitgeben; eingehende Werte werden nicht als vertrauenswürdig übernommen.
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 —
json Beispiel kopieren
{
"code" : "demo" ,
"detail" : "Demo error detail; inspect the documented code." ,
"instance" : "demo" ,
"message" : "Demo error detail; inspect the documented code." ,
"message_key" : "errors.requestFailed" ,
"message_params" : {},
"request_id" : "00000000000000000000000000000000" ,
"status" : 404,
"title" : "Demo error" ,
"type" : "about:blank"
} 409 · Anfrage abgewiesen. Prüfen Sie den stabilen Fehlercode. Stabile Fehlercodes revision_conflict preview_required
Header Typ und Grenzen Bedeutung Cache-Control string; {"pattern":"(?:^|,\\s*)no-store(?:,|$)"} Private API-Antworten verbieten Speicherung. Öffentliche OAuth-Metadaten werden 300 Sekunden gecacht; Livestreams verbieten zusätzlich Transformation. Content-Language string; {"enum":["en","de"]} Sprache lesbarer Antworttexte aus Accept-Language oder der dokumentierten Browserpräferenz. Technische Codes und Kennungen bleiben stabil. Referrer-Policy JSON; {"enum":["strict-origin-when-cross-origin","no-referrer"]} Standard-Referrerpolicy ist strict-origin-when-cross-origin. Anbieterloginantworten verwenden no-referrer zum Schutz der Loginparameter. Vary string Antworten variieren nach Accept-Language; browsergerenderte Antworten können zusätzlich nach Präferenzcookie variieren. X-Content-Type-Options JSON; {"const":"nosniff"} Der Browser muss den angegebenen Inhaltstyp verwenden. X-Frame-Options JSON; {"const":"DENY"} Die Antwort darf nicht in einem Frame eingebettet werden. X-Request-ID string Vom Server erzeugte Anfragekennung. Bei Fehlermeldungen mitgeben; eingehende Werte werden nicht als vertrauenswürdig übernommen.
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 —
json Beispiel kopieren
{
"code" : "demo" ,
"detail" : "Demo error detail; inspect the documented code." ,
"instance" : "demo" ,
"message" : "Demo error detail; inspect the documented code." ,
"message_key" : "errors.requestFailed" ,
"message_params" : {},
"request_id" : "00000000000000000000000000000000" ,
"status" : 409,
"title" : "Demo error" ,
"type" : "about:blank"
} 422 · Anfrage abgewiesen. Prüfen Sie den stabilen Fehlercode. Stabile Fehlercodes invalid_retention deletion_confirmation_required
Header Typ und Grenzen Bedeutung Cache-Control string; {"pattern":"(?:^|,\\s*)no-store(?:,|$)"} Private API-Antworten verbieten Speicherung. Öffentliche OAuth-Metadaten werden 300 Sekunden gecacht; Livestreams verbieten zusätzlich Transformation. Content-Language string; {"enum":["en","de"]} Sprache lesbarer Antworttexte aus Accept-Language oder der dokumentierten Browserpräferenz. Technische Codes und Kennungen bleiben stabil. Referrer-Policy JSON; {"enum":["strict-origin-when-cross-origin","no-referrer"]} Standard-Referrerpolicy ist strict-origin-when-cross-origin. Anbieterloginantworten verwenden no-referrer zum Schutz der Loginparameter. Vary string Antworten variieren nach Accept-Language; browsergerenderte Antworten können zusätzlich nach Präferenzcookie variieren. X-Content-Type-Options JSON; {"const":"nosniff"} Der Browser muss den angegebenen Inhaltstyp verwenden. X-Frame-Options JSON; {"const":"DENY"} Die Antwort darf nicht in einem Frame eingebettet werden. X-Request-ID string Vom Server erzeugte Anfragekennung. Bei Fehlermeldungen mitgeben; eingehende Werte werden nicht als vertrauenswürdig übernommen.
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 —
json Beispiel kopieren
{
"code" : "demo" ,
"detail" : "Demo error detail; inspect the documented code." ,
"instance" : "demo" ,
"message" : "Demo error detail; inspect the documented code." ,
"message_key" : "errors.requestFailed" ,
"message_params" : {},
"request_id" : "00000000000000000000000000000000" ,
"status" : 422,
"title" : "Demo error" ,
"type" : "about:blank"
} 503 · Anfrage abgewiesen. Prüfen Sie den stabilen Fehlercode. Stabile Fehlercodes feature_unavailable unavailable
Header Typ und Grenzen Bedeutung Cache-Control string; {"pattern":"(?:^|,\\s*)no-store(?:,|$)"} Private API-Antworten verbieten Speicherung. Öffentliche OAuth-Metadaten werden 300 Sekunden gecacht; Livestreams verbieten zusätzlich Transformation. Content-Language string; {"enum":["en","de"]} Sprache lesbarer Antworttexte aus Accept-Language oder der dokumentierten Browserpräferenz. Technische Codes und Kennungen bleiben stabil. Referrer-Policy JSON; {"enum":["strict-origin-when-cross-origin","no-referrer"]} Standard-Referrerpolicy ist strict-origin-when-cross-origin. Anbieterloginantworten verwenden no-referrer zum Schutz der Loginparameter. Retry-After string; {"pattern":"^[0-9]+$"} Sekunden bis zur Wiederholung. Bewahren Sie unterstützte Idempotenzkennungen und beachten Sie die Änderungsregeln der Operation. Vary string Antworten variieren nach Accept-Language; browsergerenderte Antworten können zusätzlich nach Präferenzcookie variieren. X-Content-Type-Options JSON; {"const":"nosniff"} Der Browser muss den angegebenen Inhaltstyp verwenden. X-Frame-Options JSON; {"const":"DENY"} Die Antwort darf nicht in einem Frame eingebettet werden. X-Request-ID string Vom Server erzeugte Anfragekennung. Bei Fehlermeldungen mitgeben; eingehende Werte werden nicht als vertrauenswürdig übernommen.
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 —
json Beispiel kopieren
{
"code" : "demo" ,
"detail" : "Demo error detail; inspect the documented code." ,
"instance" : "demo" ,
"message" : "Demo error detail; inspect the documented code." ,
"message_key" : "errors.requestFailed" ,
"message_params" : {},
"request_id" : "00000000000000000000000000000000" ,
"status" : 503,
"title" : "Demo error" ,
"type" : "about:blank"
} Für diese Änderung gibt es keine allgemeine Wiederholungsgarantie. Prüfen Sie bei unklarer Antwort den betroffenen Eintrag, bevor Sie es erneut versuchen. Beachten Sie Wartezeiten aus Retry-After und fordern Sie abgelaufene Anmelde- oder Aktionscodes neu an.
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.
shell Beispiel kopieren
curl --silent --show-error --output /dev/ null --write-out "%{http_code}\n" \
--request POST \
--header @ "$HOME/.config/metribeacon/headers.txt" \
--header "Content-Type: application/json" \
--data-binary '{"days":{"raw":3,"minute":null,"quarter_hour":null,"hour":null,"text":3},"revision":"0:0"}' \
"https://metribeacon.com/api/v1/account/retention/preview"
python Beispiel kopieren
import json
from pathlib import Path
from urllib.request import Request, HTTPRedirectHandler, build_opener
from urllib.error import HTTPError
headers = json.loads((Path.home() / ".config/metribeacon/headers.json" ).read_text())
headers[ "Content-Type" ] = "application/json"
request = Request( "https://metribeacon.com/api/v1/account/retention/preview" , data= "{\"days\":{\"raw\":3,\"minute\":null,\"quarter_hour\":null,\"hour\":null,\"text\":3},\"revision\":\"0:0\"}" .encode( "utf-8" ), headers=headers, method= "POST" )
class NoRedirect(HTTPRedirectHandler):
def redirect_request(self, request, fp, code, message, headers, target):
return None
opener = build_opener(NoRedirect())
try:
with opener.open(request, timeout=10) as response:
print(response.status)
except HTTPError as error:
print(error.code)
error.close()
javascript Beispiel kopieren
import { readFile } from "node:fs/promises" ;
import { homedir } from "node:os" ;
import { join } from "node:path" ;
const headers = JSON.parse(await readFile(join(homedir(), ".config/metribeacon/headers.json" ), "utf8" ));
headers[ "Content-Type" ] = "application/json" ;
const response = await fetch( "https://metribeacon.com/api/v1/account/retention/preview" , {
method: "POST" , headers, redirect: "manual" ,
signal: AbortSignal.timeout(10000), body: "{\"days\":{\"raw\":3,\"minute\":null,\"quarter_hour\":null,\"hour\":null,\"text\":3},\"revision\":\"0:0\"}" ,
});
console.log(response.status);
await response.body?.cancel();
go Beispiel kopieren
package main
import (
"fmt"
"net/http"
"time"
"encoding/json"
"os"
"path/filepath"
"strings"
)
func main() {
home, err := os.UserHomeDir(); if err != nil { panic( "request failed; credentials and response omitted" ) }
raw, err := os.ReadFile(filepath.Join(home, ".config/metribeacon/headers.json" )); if err != nil { panic( "request failed; credentials and response omitted" ) }
var headers map[string]string
if json.Unmarshal(raw, &headers) != nil { panic( "invalid local headers" ) }
request, err := http.NewRequest( "POST" , "https://metribeacon.com/api/v1/account/retention/preview" , strings.NewReader( "{\"days\":{\"raw\":3,\"minute\":null,\"quarter_hour\":null,\"hour\":null,\"text\":3},\"revision\":\"0:0\"}" ))
if err != nil { panic( "request failed; credentials and response omitted" ) }
for name, value := range headers { request.Header.Set(name, value) }
request.Header.Set( "Content-Type" , "application/json" )
client := &http.Client{Timeout: 10*time.Second, CheckRedirect: func (*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}
response, err := client.Do(request)
if err != nil { panic( "request failed; credentials and response omitted" ) }
defer response.Body.Close()
fmt.Println(response.StatusCode)
}
Verwandte Anleitungen HTTP-API, OAuth und MCP Finden Sie die Nutzer-API-Endpunkte mit Rechten, Feldern, Beispielen und Antwortformaten.
GET Aufbewahrungsfristen lesen (Konto)Ganze rollierende 24-Stunden-Tage, mindestens eins. Wirksam ist das Minimum aus Systemobergrenzen, Eigentümerkonto und Monitorvorgaben. Null bedeutet Vererbung. Verkürzungen sperren abgelaufene Daten sofort und starten die physische Bereinigung; pausierte Bereinigungen zeigen den Grund. Abgelaufene Daten kehren nach Verlängerung oder Zurücksetzen nicht zurück. Vorfälle, Zustellhistorien, Berichte und Sicherheitsprotokolle haben eigene Fristen; externe Kopien bleiben unberührt. Änderungen verlangen eine Browsersitzung des Eigentümers, CSRF und einen aktuellen Stand. Kontovorgaben gehören stets zum angemeldeten Nutzer, auch bei Auswahl eines geteilten Arbeitsbereichs. Mitglieder dürfen die Monitorfristen sehen; nur der Arbeitsbereicheigentümer darf sie ändern. Ist die Funktion nicht verfügbar, antworten Änderungen mit HTTP 503; die Leseantwort zeigt, ob Sie die Einstellung ändern dürfen.
PUT Bestätigte Aufbewahrung speichern (Konto)Ganze rollierende 24-Stunden-Tage, mindestens eins. Wirksam ist das Minimum aus Systemobergrenzen, Eigentümerkonto und Monitorvorgaben. Null bedeutet Vererbung. Verkürzungen sperren abgelaufene Daten sofort und starten die physische Bereinigung; pausierte Bereinigungen zeigen den Grund. Abgelaufene Daten kehren nach Verlängerung oder Zurücksetzen nicht zurück. Vorfälle, Zustellhistorien, Berichte und Sicherheitsprotokolle haben eigene Fristen; externe Kopien bleiben unberührt. Änderungen verlangen eine Browsersitzung des Eigentümers, CSRF und einen aktuellen Stand. Kontovorgaben gehören stets zum angemeldeten Nutzer, auch bei Auswahl eines geteilten Arbeitsbereichs. Mitglieder dürfen die Monitorfristen sehen; nur der Arbeitsbereicheigentümer darf sie ändern. Ist die Funktion nicht verfügbar, antworten Änderungen mit HTTP 503; die Leseantwort zeigt, ob Sie die Einstellung ändern dürfen.
DELETE Geerbte Aufbewahrung wiederherstellen (Konto)Ganze rollierende 24-Stunden-Tage, mindestens eins. Wirksam ist das Minimum aus Systemobergrenzen, Eigentümerkonto und Monitorvorgaben. Null bedeutet Vererbung. Verkürzungen sperren abgelaufene Daten sofort und starten die physische Bereinigung; pausierte Bereinigungen zeigen den Grund. Abgelaufene Daten kehren nach Verlängerung oder Zurücksetzen nicht zurück. Vorfälle, Zustellhistorien, Berichte und Sicherheitsprotokolle haben eigene Fristen; externe Kopien bleiben unberührt. Änderungen verlangen eine Browsersitzung des Eigentümers, CSRF und einen aktuellen Stand. Kontovorgaben gehören stets zum angemeldeten Nutzer, auch bei Auswahl eines geteilten Arbeitsbereichs. Mitglieder dürfen die Monitorfristen sehen; nur der Arbeitsbereicheigentümer darf sie ändern. Ist die Funktion nicht verfügbar, antworten Änderungen mit HTTP 503; die Leseantwort zeigt, ob Sie die Einstellung ändern dürfen.