API-ReferenzPUT

Alert-Einstellungen aktualisieren

Aktiviert oder deaktiviert E-Mail-Alerts und legt ihre Kadenz fest.

PUThttps://ai.redreplier.com/ai-app/api/v1/alert-settings

Aktiviert oder deaktiviert E-Mail-Alerts und legt ihre Kadenz fest.

Bearer-Token (RedReplier-API-Token)

Authentifizierung

Sende bei jeder Anfrage ein RedReplier-API-Token als Bearer-Token. Tokens beginnen mit redreplier_; RedReplier ermittelt das Konto aus dem Token.

Authorization: Bearer redreplier_test_1234567890
Content-Type: application/json

Parameter

Dieser Endpoint hat keine Pfad- oder Query-Parameter.

Request-Body

  • enabled (Boolean, erforderlich): Aktiviert oder deaktiviert E-Mail-Alerts.
  • cadenceMinutes (Integer, optional): Gewünschte Kadenz. Übliche erlaubte Werte sind 60, 240, 720 und 1440; die Antwort enthält die für den aktuellen Tarif verfügbaren Werte.

Antwort

Gibt Alert-Einstellungen für das Token-Konto zurück.

  • enabled (boolean): Gibt an, ob E-Mail-Alerts aktiviert sind.
  • cadenceMinutes (number): Konfigurierte Alert-Kadenz in Minuten.
  • minIntervalMinutes (number): Schnellste vom aktuellen Tarif erlaubte Kadenz.
  • availableCadences (number[]): Für den aktuellen Tarif verfügbare Kadenzwerte.

Beispielanfrage

curl -X PUT https://ai.redreplier.com/ai-app/api/v1/alert-settings \
  -H 'Authorization: Bearer redreplier_test_1234567890' \
  -H 'Content-Type: application/json' \
  -d '{"enabled":true,"cadenceMinutes":240}'

Hinweise

Wenn die angeforderte Kadenz schneller ist als der Tarif erlaubt, setzt RedReplier sie auf minIntervalMinutes.

Fehler

  • 400 Bad Request: Ungültige Eingabe, URL, UUID, Enum, Query-Parameter oder Body.
  • 401 Unauthorized: Fehlendes oder ungültiges Bearer-Token.
  • 404 Not Found: Die Ressource existiert nicht für das Token-Konto.
  • 500 Internal Server Error: Unerwarteter Serverfehler.
Beispielanfrage (curl)
curl --request PUT \
  --url https://ai.redreplier.com/ai-app/api/v1/alert-settings \
  --header 'Authorization: Bearer redreplier_test_1234567890' \
  --header 'Content-Type: application/json' \
  --data '{"enabled":true,"cadenceMinutes":240}'
200
{
  "enabled": true,
  "cadenceMinutes": 240,
  "minIntervalMinutes": 60,
  "availableCadences": [60, 240, 720, 1440]
}