Wie installiere und aktiviere ich REST API Pro (inkl. Lizenz)?

Wie installiere und aktiviere ich REST API Pro (inkl. Lizenz)?

Die Installation dauert nur wenige Minuten und läuft komplett über die normale Perfex-Modulverwaltung. Du brauchst dafür einen Admin-Zugang und deinen Lizenzschlüssel aus dem Kauf.

📦 Schritt für Schritt

1. Öffne in Perfex Setup → Module.
2. Lade die ZIP-Datei von REST API Pro hoch (alternativ das Modul in den modules/ -Ordner entpacken).
3. Klicke bei REST API Pro auf Aktivieren und, falls Perfex dazu auffordert, auf Datenbank aktualisieren.
4. Wechsle zu REST API Pro → Einstellungen und trage dort deinen Lizenzschlüssel ein. Klicke auf Lizenz aktivieren.

Nach erfolgreicher Aktivierung zeigt der Status Aktiv an und die API ist freigeschaltet. Ohne gültige Lizenz antwortet jeder API-Aufruf mit einem sauberen Fehler (HTTP 403) und einem Klartext-Hinweis.

🔑 Das Lizenzmodell: 1 oder 5 Domains

• Regular-Lizenz = 1 Domain. Ideal, wenn du eine einzige Perfex-Installation betreibst.
• Extended-Lizenz = 5 Domains. Passend für Agenturen oder mehrere Umgebungen (z. B. Live, Staging, Kundeninstanzen).

Deine Lizenz ist an die Domains gebunden, auf denen du sie aktivierst. Jede aktivierte Domain zählt gegen dein Kontingent.

🔁 Server- oder Domainwechsel (Self-Service)

Ein Umzug sperrt dich nie aus. Wenn du auf einen neuen Server oder eine neue Domain wechselst, gibst du die alte Domain einfach selbst wieder frei: Melde dich in deinem Shop-Kundenkonto an, deaktiviere die alte Aktivierung und aktiviere die neue Domain. Das läuft komplett per Self-Service, ganz ohne Support-Ticket.

✅ Voraussetzungen

• Perfex CRM 3.0 oder neuer
• PHP 7.4+ (empfohlen 8.x)
• PHP-cURL-Erweiterung (wird für Webhooks und die Lizenzprüfung benötigt)

💡 Tipp zum Cron

Für zuverlässige Webhook-Zustellung und die automatische Log-Bereinigung sollte der Perfex-Cron eingerichtet sein. Die Health-Card auf der Einstellungsseite zeigt dir an, ob der Cron regelmäßig läuft.

🛟 Hilfe

Hakt etwas bei Installation oder Aktivierung? Der öffentliche Bug-Tracker unter service.pixagentur.com/bug_tracker/rest-api-pro ist die schnellste Anlaufstelle.