Zum Hauptinhalt springen

Sprint 347 — API v2: RESTful-API + Webhooks für externe Integrationen

· 2 Minuten Lesezeit

Pragma bekommt eine vollständige Developer API — mit REST-Endpoints, skalierten API Keys, Webhooks und einer integrierten Dokumentationsseite.

Was neu ist​

API v2 — RESTful Endpoints​

Externe Tools und Skripte können ab sofort direkt mit Pragma kommunizieren:

EndpointBeschreibung
GET /api/v2/workspaceWorkspace-Info und Statistiken
GET /api/v2/signalsSignale aus dem Inbox auflisten
POST /api/v2/signalsNeues Signal einspeisen
GET /api/v2/leadsLeads auflisten (mit Pagination)
GET /api/v2/leads/{id}Einzelnen Lead abrufen
POST /api/v2/leadsLead erstellen
GET /api/v2/contactsKontakte auflisten
GET /api/v2/contacts/{id}Einzelnen Kontakt abrufen

Granulare API Key Scopes​

Jeder API Key bekommt genau die Berechtigungen, die er braucht — kein mehr:

  • signals:read / signals:ingest
  • leads:read / leads:write
  • contacts:read / contacts:write
  • deals:read
  • webhooks:read / webhooks:write

Webhooks — Echtzeit-Events​

Wenn ein Webhook registriert ist, sendet Pragma sofort bei diesen Events einen POST:

  • signal.created — neues Signal im Inbox
  • lead.created / lead.updated
  • deal.updated
  • message.created
  • billing.activated

Alle Webhooks werden mit HMAC-SHA256 signiert (X-Pragma-Signature) und bei Fehlern bis zu 5x wiederholt.

Developer API in den Einstellungen​

Unter Settings → Developer API lassen sich direkt im Browser:

  • API Keys erstellen (mit Scope-Auswahl) und widerrufen
  • Webhooks mit beliebiger URL und Event-Auswahl registrieren
  • Neue Keys sicher kopieren (einmalige Anzeige)

Developer Docs unter /developer​

Vollständige API-Dokumentation mit Code-Beispielen, curl-Snippets und Zapier-Anleitung.

Warum das wichtig ist​

Die API v2 ist die Grundlage für Sprint 343 (Zapier Official App) und öffnet Pragma für den No-Code-Ökosystem mit über 7.000 Zapier-Apps und Millionen Make-Nutzern.