API-ReferenzDEL

Website löschen

Beendet die Überwachung einer Website und entfernt alle zugehörigen Keywords aus dem authentifizierten Konto.

DELETEhttps://ai.redreplier.com/ai-app/api/v1/websites/{websiteId}

Beendet die Überwachung einer Website und entfernt alle zugehörigen Keywords aus dem authentifizierten Konto.

Bearer-Token (RedReplier-API-Token)

Parameter

  • websiteId (Pfad, UUID, erforderlich): Website, deren Überwachung beendet wird.

Request-Body

Dieser Endpoint benötigt keinen JSON-Body.

Antwort

Gibt eine Löschbestätigung zurück.

  • deleted (boolean): Immer true, wenn das Löschen erfolgreich war.

Hinweise

Diese Aktion beendet die Überwachung. Bestätigen Sie die Website vor dem Aufruf. Die aktiven Keywords der Website geben ihre Plätze im Tarif frei, sodass die ältesten ausstehenden Keywords anderer Websites, die hineinpassen, aktiv werden und das Monitoring starten.

Fehler

  • 400 Bad Request: Ungültige Eingabe, URL, UUID, Enum, Query-Parameter oder Body.
  • 401 Unauthorized: Fehlendes oder ungültiges Bearer-Token, oder code: "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", wenn X-Workspace-Id einen Workspace nennt, den diese Zugangsdaten nicht erreichen, oder code: "permission_denied", wenn Ihre Rolle im Workspace die Berechtigung redreplier.write nicht 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 aus Retry-After ab.
  • 500 Internal Server Error: Unerwarteter Serverfehler.
Beispielanfrage (curl)
curl --request DELETE \
  --url https://ai.redreplier.com/ai-app/api/v1/websites/9b0f2b8d-4a76-4f59-9f0b-6b4b6f6c2a10 \
  --header 'Authorization: Bearer redreplier_test_1234567890'
200
{
  "deleted": true
}