Hilfe-Center
Konto, Agenturen & API

API-Zugang einrichten

Für alle, die einen Shop, eine Kasse oder eigene Software an Reputify anbinden: eine Zugangsmarke je Programm, nur mit den Rechten, die es braucht.

Für wen ist dieser Artikel? Für Sie, wenn ein anderes Programm automatisch mit Reputify arbeiten soll – etwa Ihr Shop- oder Kassensystem, eine eigene Software oder ein Auswertungs-Werkzeug – und Sie dafür einen Zugang einrichten, den Ihr Programmierer oder Dienstleister einträgt. Der technische Teil weiter unten ist für ihn gedacht.

Für WordPress brauchen Sie das alles nicht: Dafür gibt es einen fertigen Weg ohne Schlüssel, siehe Das WordPress-Plugin.

Was ist eine Zugangsmarke?

Eine Zugangsmarke (auch API-Schlüssel oder Token) ist ein langes, zufälliges Passwort für ein Programm. Das Programm zeigt sie bei jeder Anfrage vor; Reputify erkennt daran, wer fragt und was er darf. Die API ist die Schnittstelle, über die Programme mit Reputify sprechen. Es gibt zwei Arten von Marken:

ArtBeginnt mitKannWo ausstellen
Team-Zugangrpf_live_was die angehakten Rechte erlaubenAPI-Zugriff → API-Schlüssel (Seite „API & Anbindungen“)
Umfrage-Zugangrpf_inv_nur zu dieser einen Umfrage einladen – nichts lesen, nichts löschenin der Bewertungsumfrage, Reiter Anbindung (jeder Tarif)

Bevor Sie beginnen

  • Sie sind Inhaber oder Administrator des Teams. Andere Rollen sehen den Menüpunkt API-Schlüssel nicht – wer eine Marke ausstellt, öffnet eine Tür in Ihr Konto.
  • Für die meisten Rechte (Bewertungen, Projekte, Auswertungen lesen, antworten) brauchen Sie mindestens den Tarif Pro. Einbettungen, Siegel und Einladungen gehen in jedem Tarif.
  • Für einen Umfrage-Zugang: eine Bewertungsumfrage, bei der unter Wie kommen die Leute zur Bewertung? der Zugang Aus meinem System (Shop, Kasse, MCP) angehakt ist (siehe Bewertungen einholen mit Umfragen).

1. Team-Zugang ausstellen

  1. Klicken Sie links in der Seitenleiste ganz unten unter API-Zugriff auf API-Schlüssel. Es öffnet sich die Seite API & Anbindungen. (Wo die Seitenleiste ist: So finden Sie sich in Reputify zurecht.)
  2. Tragen Sie rechts unter Neue Marke bei Name (2 im Bild) ein, wofür die Marke ist, zum Beispiel „Auswertung Controlling“ oder „Kassensystem Filiale Graz“. Den Namen sehen später nur Sie.
  3. Haken Sie unter Rechte nur an, was das Programm wirklich braucht. Fragen Sie im Zweifel Ihren Programmierer. Rechte, die Ihr Tarif nicht enthält, sind mit „Ihr Tarif deckt das nicht ab.“ gekennzeichnet.
  4. Optional: Tragen Sie bei Gültig für (Tage) ein, wie lange die Marke gelten soll. Leer heißt unbefristet.
  5. Klicken Sie auf Ausstellen.
  6. Die Marke erscheint jetzt ein einziges Mal mit dem Hinweis „Jetzt kopieren — danach ist sie nicht mehr einsehbar“. Kopieren Sie sie und geben Sie sie sicher an Ihren Programmierer weiter. Klicken Sie danach auf Habe ich kopiert.
Bildschirmfoto: Seite «API & Anbindungen» mit dem Formular «Neue Marke»
Die Seite «API & Anbindungen»: rechts das Formular «Neue Marke» mit dem Feld «Name» (2) und darunter die Rechte zum Anhaken.

So sehen Sie, dass es geklappt hat

Die Marke steht links in der Liste mit Name, dem Anfang der Marke, den Rechten, Zuletzt (wann sie zuletzt benutzt wurde) und Aufrufe. Sobald das Programm angebunden ist, zählen die Aufrufe hoch.

Geben Sie jedem Programm eine eigene Marke. Dann können Sie eine sperren, ohne die anderen zu stören, und sehen an Zuletzt und Aufrufe, welche noch benutzt wird.

Die Rechte

RechtTarif
Ihre Projekte und Kennzahlen lesenab Pro
Ihre Bewertungen lesenab Pro
Auf Bewertungen antwortenab Pro
Video- und Audio-Bewertungen lesenab Pro
Social-Exporte erzeugen und Bewertungen hervorhebenab Pro
Sehen, welche Umfragen es gibt und ob sie laufenab Pro
KI-Auswertungen Ihrer Projekte lesenab Pro
Ihre Auszeichnungen lesenab Pro
Interne Rückmeldungen lesenab Pro
Bewertungsumfragen anlegen und ändernab Pro
Einbettungen anlegen und ändernjeder Tarif
Kunden zu einer Bewertung einladenjeder Tarif
Ihre Siegel und Bewertungsbausteine anzeigenjeder Tarif

Auf Bewertungen antworten geht über die API für dieselben Bewertungen wie im Dashboard: solche, die über Reputify entstanden sind, und Google-Bewertungen bei offiziell verbundenem Google-Konto. Bei allen anderen antwortet man auf der Plattform selbst (siehe Auf Bewertungen antworten).

Kein Recht kann eine Bewertung löschen oder verbergen. Projekte, Plattformen oder Bewertungen anlegen geht über die API nicht – der Kasten Noch nicht verfügbar auf der Seite nennt diese Rechte. Ob Ihr Tarif ein Recht abdeckt, wird bei jedem Aufruf geprüft: Nach einem Tarifwechsel gilt sofort der neue Stand.

2. Anfragen senden (für Programmierer)

Die Marke wird bei jeder Anfrage im Authorization-Header mitgeschickt:

Authorization: Bearer rpf_live_…

Listen liefern höchstens 100 Einträge pro Seite. Antworten tragen ein ETag; mit If-None-Match sparen Sie Datenvolumen, wenn sich nichts geändert hat. Wie viele Anfragen pro Minute erlaubt sind, hängt vom Tarif ab: Free 30, Starter 60, Pro 120, Agency Light 300, Agency 600. Gezählt wird für das ganze Konto, bei Agenturen samt ihren Mandanten. Alle Endpunkte stehen in der API-Dokumentation – in Reputify links unter API-Zugriff → Dokumentation.

Mit einer fertigen Bibliothek (SDK)

Statt die Anfragen selbst zu bauen, kann Ihr Programmierer eines der offiziellen Pakete verwenden – für PHP (ab 8.1) und für JavaScript/TypeScript (Node 18+, Deno, Bun, Cloudflare Workers). Sie kennen alle Endpunkte, blättern Listen selbstständig durch, warten bei erreichtem Tariflimit und prüfen die Signatur von Webhooks:

composer require reputify/reputify-php
npm install @reputify/sdk
$reputify = new Reputify\Reputify('rpf_live_…');
$reviews  = $reputify->reviews->list(42, ['min_rating' => 4]);

Beide Pakete sind quelloffen (MIT-Lizenz); die Anleitung steht jeweils auf Packagist und npm. Wichtig: Die Marke gehört nur auf den Server, nie in den Quelltext einer Website.

3. Kunden aus Shop oder Kasse einladen

Soll Ihr System nach einem Kauf nur eine Einladung zur Bewertung auslösen, brauchen Sie keinen Team-Zugang, sondern einen Umfrage-Zugang. Er geht in jedem Tarif.

  1. Klicken Sie links in der Seitenleiste unter Bewertungsextras auf Bewertungsumfragen und bei der gewünschten Umfrage auf Bearbeiten.
  2. Klicken Sie oben auf den Reiter Anbindung (1 im Bild). Fehlt er, ist im Reiter Grundlegendes der Zugang Aus meinem System (Shop, Kasse, MCP) nicht angehakt.
  3. Tragen Sie bei Neuer Token einen Namen ein, zum Beispiel „WooCommerce Hauptshop“, und klicken Sie auf Erzeugen (2 im Bild).
  4. Kopieren Sie den Token sofort – auch er wird nur einmal gezeigt – und geben Sie ihn an Ihren Programmierer weiter. Darunter steht unter So ruft Ihr System uns auf ein fertiges Beispiel für ihn.
Bildschirmfoto: Bewertungsumfrage, Reiter «Anbindung» mit «Neuer Token» und «Erzeugen»
Der Umfrage-Editor: 1 der Reiter «Anbindung», 2 der Knopf «Erzeugen» neben dem Feld «Neuer Token».

Technisch: Das System ruft mit dem Token POST https://api.reputify.io/v1/invite auf. Wann die Einladung hinausgeht, stellen Sie im Reiter E-Mail der Umfrage ein; ein einzelner Aufruf darf diese Frist mit delay_hours überschreiben. Übergeben Sie eine Bestellnummer – dieselbe Nummer erzeugt keine zweite Einladung. Artikel der Bestellung können mitgeschickt werden und erscheinen später an der Bewertung.

4. KI-Assistenten (MCP)

Mit demselben Umfrage-Zugang binden Sie KI-Assistenten wie Claude oder Cursor über https://api.reputify.io/v1/mcp an. Der Assistent kann Informationen zur Umfrage abrufen, Kunden einladen und den Stand einer Einladung sehen – keine Bewertungstexte lesen und nichts löschen. Die fertige Einstellung steht im Reiter Anbindung unter Für KI-Agenten (MCP). MCP gibt es ab dem Tarif Pro.

5. Webhooks

Ein Webhook ist der umgekehrte Weg: Reputify meldet sich bei Ihrem System, sobald etwas passiert. Tragen Sie dazu in der Umfrage im Reiter Nach der Abgabe eine Webhook-Adresse ein (ab Tarif Pro). Gemeldet werden neue Bewertungen (review.submitted), Weiterleitungen zu Plattformen (review.handover) und interne Rückmeldungen (feedback.received). Jede Zustellung trägt den Header X-Reputify-Signature: sha256=… – eine HMAC-SHA256-Signatur über den Inhalt. Fehlgeschlagene Zustellungen werden bis zu dreimal versucht und protokolliert.

Sperren und trennen

Eine Team-Marke sperren Sie auf der Seite API & Anbindungen in der Liste mit Sperren, einen Umfrage-Token im Reiter Anbindung ebenfalls mit Sperren. Programme, die Sie über den Verbinden-Dialog freigegeben haben – etwa das WordPress-Plugin –, stehen auf der Seite API & Anbindungen unter Verbundene Anwendungen und lassen sich dort mit Verbindung trennen entfernen.

Häufige Fragen

Ich sehe den Menüpunkt „API-Schlüssel“ nicht.

Er ist nur für Inhaber und Administratoren des Teams sichtbar. Bitten Sie den Inhaber, die Marke auszustellen, oder Ihnen die Rolle Administrator zu geben (siehe Team einladen und Rollen vergeben).

Ein Recht lässt sich nicht anhaken.

Ihr Tarif enthält es nicht – die meisten Leserechte gibt es ab Pro. Siehe Plan wechseln oder kündigen.

Ich habe die Marke nicht kopiert.

Sie lässt sich nicht noch einmal anzeigen. Sperren Sie sie und stellen Sie eine neue aus.

Keine Antwort gefunden?

Unser Support-Team hilft Ihnen gerne weiter.

Hilfe