API-ReferenzPUT
Alert-Einstellungen aktualisieren
Aktiviert oder deaktiviert E-Mail-Alerts für neue relevante Mentions und legt fest, wie oft RedReplier sie sendet.
PUT
https://ai.redreplier.com/ai-app/api/v1/alert-settingsAktiviert oder deaktiviert E-Mail-Alerts für neue relevante Mentions und legt fest, wie oft RedReplier sie sendet.
Bearer-Token (RedReplier-API-Token)
Parameter
Dieser Endpoint hat keine Pfad- oder Query-Parameter.
Request-Body
enabled(Boolean, erforderlich): Aktiviert oder deaktiviert E-Mail-Alerts.cadenceMinutes(Integer, optional): Digest-Intervall in Minuten, einer von15,30,60,120,180,240,720oder1440; jeder andere Wert liefert 400. Ohne Wert wird die schnellste im Tarif erlaubte Kadenz gesetzt, senden Sie also den aktuellen Wert mit, wenn Sie nurenabledumschalten.
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.
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, odercode: "token_issuer_lost_access", wenn die Person, die den API-Schlüssel erstellt hat, deaktiviert wurde oder den Workspace verlassen hat.403 Forbidden:code: "subscription_required", wenn der Tarif des Workspace keinen API-Zugang enthält,code: "workspace_access_denied", wennX-Workspace-Ideinen Workspace nennt, den diese Zugangsdaten nicht erreichen, odercode: "permission_denied", wenn Ihre Rolle im Workspace die Berechtigungredreplier.writenicht hat (Admin und Editor haben sie).404 Not Found: Die Ressource existiert nicht für das Token-Konto.429 Too Many Requests: Rate-Limit überschritten. Warten Sie die Sekunden ausRetry-Afterab.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, 120, 180, 240, 720, 1440]
}