REST API

Die Replix REST API ermöglicht es dir, KI-Bewertungsantworten von externen Anwendungen aus zu generieren. Du kannst die API in dein eigenes CRM, Dashboard oder Automatisierungs-Tool integrieren. Die API ist ausschließlich im Agentur-Plan verfügbar.

Gehe zu Einstellungen → API-Keys → 'Neuen Key erstellen'. Der Key wird im Format rplx_... generiert und nur einmalig vollständig angezeigt — kopiere ihn sofort! Der Key wird als SHA-256-Hash in der Datenbank gespeichert. MFA ist zum Erstellen erforderlich.

Sende den API-Key als Bearer-Token im Authorization-Header:

Authorization: Bearer rplx_dein_api_key

Beispiel mit curl:

curl -X POST https://www.replixapp.com/api/v1/generate -H "Authorization: Bearer rplx_..." -H "Content-Type: application/json" -d '{"reviewText": "Toller Service!", "rating": 5, "tone": "freundlich", "industry": "restaurant", "businessName": "Mein Restaurant"}'

POST /api/v1/generate akzeptiert folgende JSON-Parameter: reviewText (Pflicht, max. 5000 Zeichen) — der Bewertungstext. rating (Pflicht, 1–5) — Sternebewertung. tone (Optional) — freundlich, professionell, empathisch, locker oder formell. industry (Optional) — restaurant, hotel, arztpraxis, friseur, handwerk, einzelhandel oder allgemein. businessName (Optional) — dein Firmenname. language (Optional) — wird automatisch erkannt, wenn nicht angegeben. variants (Optional, 1–3) — Anzahl der Antwortvarianten.

Die REST API ist auf 60 Anfragen pro Minute begrenzt. Jede generierte Antwort zählt gegen dein monatliches Antwort-Kontingent (im Agentur-Plan unbegrenzt, technisch 500 in der Testphase). Bei Überschreitung des Rate-Limits erhältst du einen 429-Statuscode.

Die API gibt ein JSON-Objekt zurück mit: response (die generierte Antwort), language (erkannte Sprache), tone (verwendetes Tonprofil), und bei mehreren Varianten ein variants-Array. Bei Fehler erhältst du error mit einer Beschreibung. HTTP-Statuscodes: 200 (Erfolg), 400 (ungültige Parameter), 401 (ungültiger API-Key), 429 (Rate-Limit), 500 (Server-Fehler).