API v1.0

Entwickler-API

Integrieren Sie SignaGenius in Ihre bestehenden Workflows. Unsere REST API ermöglicht es Ihnen, Teammitglieder programmatisch zu verwalten, Synchronisierungen auszulösen und Echtzeit-Analysen abzurufen.

Authentifizierung

Alle API-Anfragen müssen mit einem Bearer-Token authentifiziert werden. Sie können Ihre API-Schlüssel im Admin Panel > Einstellungen > Entwickler generieren.

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://panel.signagenius.com/api/v1/users

Endpoints

GET/users

Alle Teammitglieder und deren Signaturstatus auflisten.

Scope: users:read?limit=1...200?offset=0...1000000
POST/users

Einen verwalteten Workspace-Benutzer anlegen.

Scope: users:write
GET/users/{id}

Einen mandantenbezogenen verwalteten Benutzer abrufen.

Scope: users:read
PATCH/users/{id}

Unterstützte Profilfelder oder den Kontostatus aktualisieren.

Scope: users:write
DELETE/users/{id}

Einen Benutzer weich deaktivieren und seinen Audit-Verlauf behalten.

Scope: users:write
POST/users/batch

Bis zu 100 Benutzer anlegen, aktualisieren oder deaktivieren - mit Ergebnis je Zeile und idempotenter Wiederholung.

Scope: users:writeheader: Idempotency-Key
GET/signatures

Die 200 neuesten generierten Signatur-Artefakte auflisten.

Scope: signatures:read?user_id
GET/change-requests

Regulierte Anfragen zur Profiländerung auflisten.

Scope: requests:read?status=pending|approved|rejected
GET/analytics

Link-Klick-Analysen für einen bestimmten Zeitraum abrufen.

Scope: analytics:read?days=1...365
GET/audiences

Wiederverwendbare Kampagnen-Zielgruppen und ihre aufgelösten Mitglieder auflisten.

Scope: audiences:read
POST/audiences

Eine per API verwaltete Zielgruppe anlegen oder idempotent ersetzen.

Scope: audiences:write
GET/audiences/{id}

Eine Zielgruppe mit ihren aufgelösten Mitgliedern abrufen.

Scope: audiences:read
PUT/audiences/{id}

Eine Zielgruppe und ihre gesamte Mitgliederliste ersetzen.

Scope: audiences:write
DELETE/audiences/{id}

Eine wiederverwendbare Zielgruppe löschen.

Scope: audiences:write
GET/webhooks

Signierte Webhook-Abos ohne ihre Geheimnisse auflisten.

Scope: webhooks:write
POST/webhooks

Ein Abo anlegen und sein Signaturgeheimnis einmalig erhalten.

Scope: webhooks:write
PATCH/webhooks/{id}

Ein Webhook-Abo aktualisieren, aktivieren oder pausieren.

Scope: webhooks:write
DELETE/webhooks/{id}

Ein Webhook-Abo löschen.

Scope: webhooks:write
GET/export

Einen versionierten Export der Workspace-Konfiguration herunterladen - ohne Zugangsdaten, Geheimnisse, Ereignisverlauf oder rekonstruierbare Artefakte.

Scope: exports:read

Brauchen Sie Hilfe?

Unser Engineering-Team ist hier, um Ihnen bei Ihrer Integration zu helfen.

Support kontaktieren