Was ist REST API Pro und was kann es?

REST API Pro ist die umfassende REST-Schnittstelle für dein Perfex CRM. Sie öffnet dein gesamtes CRM über ein einziges, sauberes Gateway ( /rest_api_pro/v1 ) und ist für Integratoren, Agenturen und No-Code-Fans gebaut. Egal ob Zapier, Make, ein eigenes Portal oder eine Mobile-App: Du liest und schreibst deine CRM-Daten über eine konsistente JSON-Schnittstelle.

🚀 Die wichtigsten Funktionen

~30 Ressourcen mit CRUD, wo es Sinn ergibt: Kunden, Kontakte, Leads, Rechnungen, Angebote, Proposals, Gutschriften, Zahlungen, Ausgaben, Projekte, Tasks, Meilensteine, Verträge, Tickets (inkl. Antworten), Mitarbeiter, Abonnements, Timesheets, Kalender, Artikel, Steuern, Währungen, Zahlungsarten, Abteilungen, Notizen, Wissensdatenbank, Ankündigungen, Aktivitätslog und mehr.
Sichere API-Keys: nur als SHA-256-Hash gespeichert, mit Scopes je Ressource, Ablaufdatum, IP-Whitelist und Rate-Limit pro Key.
Query-Features überall: Paging, Filter, Sortierung, Sparse-Fields, include für Kind-Sammlungen und Sync-Fenster.
Aktionen: PDF erzeugen, per E-Mail versenden, Angebot in Rechnung umwandeln, Lead konvertieren, Task-Timer, Ticket-Antworten und Anhänge.
57 Webhooks (HMAC-signiert, mit Wiederholungen), Request-Log & Analytics, Batch-Requests, globale Suche und Statistiken.
Eingebaute OpenAPI-3.1-Doku mit Try-it-Playground direkt im Browser.

🆚 Abgrenzung zur Standard-Perfex-API

Perfex bringt von Haus aus nur sehr begrenzte API-Fähigkeiten mit, und auch die verbreitete ältere "REST API for Perfex CRM" hat spürbare Lücken: kein Paging, keine Filter, kein Rate-Limit, keine Logs, keine Webhooks, keine funktionierende Doku und teils im Klartext gespeicherte Tokens. REST API Pro schließt genau diese Lücken und geht deutlich darüber hinaus.

Konkret bedeutet das: Eine Listenabfrage liefert bei REST API Pro nicht stumpf alle Datensätze, sondern sauber paginierte, filter- und sortierbare Ergebnisse mit korrekten HTTP-Statuscodes. Keys sind gehasht statt im Klartext, jede Anfrage lässt sich im Log nachvollziehen, und du kannst Ereignisse aktiv per Webhook an andere Systeme pushen.

👤 Für wen ist das gedacht?

Für alle, die Perfex mit anderen Tools verbinden wollen, ohne selbst am Perfex-Code zu schrauben: Automatisierungen über Zapier/Make, Anbindung an Buchhaltung oder Shop, eigene Dashboards, mobile Zugriffe. Du brauchst kein tiefes Perfex-Wissen, um loszulegen.

🛟 Support

Fragen oder ein Problem? Nutze den öffentlichen Bug-Tracker unter service.pixagentur.com/bug_tracker/rest-api-pro.