API-ReferenzPOST

Website-Beschreibung analysieren

Erzeugt vor dem Erstellen oder Aktualisieren einer Website eine KI-Beschreibung aus einer URL.

POSThttps://ai.redreplier.com/ai-app/api/v1/websites/analyze-description

Erzeugt vor dem Erstellen oder Aktualisieren einer Website eine KI-Beschreibung aus einer URL.

Bearer-Token (RedReplier-API-Token)

Parameter

Dieser Endpoint hat keine Pfad- oder Query-Parameter.

Request-Body

  • url (String, URL, erforderlich): Website-URL, die analysiert wird.

Antwort

Gibt die erzeugte Beschreibung zurück.

  • description (string): KI-generierte Zusammenfassung der Website oder des Produkts.

Hinweise

Nutzen Sie dies vor dem Erstellen oder Aktualisieren, wenn Sie die KI-generierte Beschreibung prüfen möchten.

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 POST \
  --url https://ai.redreplier.com/ai-app/api/v1/websites/analyze-description \
  --header 'Authorization: Bearer redreplier_test_1234567890' \
  --header 'Content-Type: application/json' \
  --data '{"url": "https://acmecrm.io"}'
201
{
  "description": "Acme CRM helps small agencies manage sales pipelines, client relationships, and follow-up workflows."
}