Website erstellen

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

• url (String, URL, erforderlich): Website-URL.
• name (String, optional): Anzeigename.
• keywords (String[], optional): Anfängliche Keyword-Werte; jeder Wert darf bis zu 255 Zeichen haben.
• description (String, optional, max. 5000): Manuelle Website-Beschreibung. Wenn sie fehlt, kann RedReplier die URL crawlen oder analysieren.

Antwort

Gibt ein öffentliches Website-Objekt zurück.

Website-Objekt

• id (string): Website-UUID.
• accountGroupId (string): Aus dem Token ermittelte Account-Gruppe.
• domain (string): Normalisierte Website-Domain.
• url (string): Website-URL.
• name (string | null): Anzeigename.
• description (string | null): Kontext für die Relevanzbewertung.
• createdAt, updatedAt (ISO string | null): Erstellungs- und Aktualisierungszeitpunkte im ISO-8601-Format oder null.
• keywords (Keyword[]): Keyword-Objekte für diese Website.

Keyword-Objekt

• id (string): Keyword-UUID.
• websiteId (string): UUID der übergeordneten Website.
• value (string): Keyword-Text mit bis zu 255 Zeichen.
• status (string): PENDING, ACTIVE, DISABLED oder SUSPENDED.
• createdAt, updatedAt (ISO string | null): Erstellungs- und Aktualisierungszeitpunkte im ISO-8601-Format oder null.

Beispielanfrage

curl -X POST https://ai.redreplier.com/ai-app/api/v1/websites \
  -H 'Authorization: Bearer redreplier_test_1234567890' \
  -H 'Content-Type: application/json' \
  -d '{"url":"https://acmecrm.io","name":"Acme CRM","keywords":["agency CRM"]}'

Hinweise

Anfängliche Keywords starten als PENDING; Keywords, die in den Tarif passen, können ACTIVE werden.

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.