API v1.0

Ontwikkelaars-API

Integreer SignaGenius in uw bestaande workflows. Onze REST API stelt u in staat om teamleden programmatisch te beheren, synchronisaties te activeren en real-time analytics op te halen.

Authenticatie

Alle API-verzoeken moeten worden geauthenticeerd met een Bearer-token. U kunt uw API-sleutels genereren in Admin Panel > Instellingen > Ontwikkelaars.

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

Eindpunten

GET/users

Lijst van alle teamleden en hun handtekeningstatus.

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

Een beheerde werkruimtegebruiker aanmaken.

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

Eén beheerde gebruiker binnen de tenant ophalen.

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

Ondersteunde profielvelden of de accountstatus bijwerken.

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

Een gebruiker zacht uitschakelen met behoud van zijn auditgeschiedenis.

scope: users:write
POST/users/batch

Tot 100 gebruikers aanmaken, bijwerken of uitschakelen, met resultaat per rij en idempotente herhaling.

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

De 200 nieuwste gegenereerde handtekeningartefacten tonen.

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

Beheerde verzoeken tot profielwijziging tonen.

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

Haal link-klik analytics op voor een specifiek tijdsbereik.

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

Herbruikbare campagnedoelgroepen en hun opgeloste leden tonen.

scope: audiences:read
POST/audiences

Een via de API beheerde doelgroep aanmaken of idempotent vervangen.

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

Eén doelgroep met haar opgeloste leden ophalen.

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

Een doelgroep en haar volledige ledenlijst vervangen.

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

Een herbruikbare doelgroep verwijderen.

scope: audiences:write
GET/webhooks

Ondertekende webhook-abonnementen tonen zonder hun geheimen.

scope: webhooks:write
POST/webhooks

Een abonnement aanmaken en het ondertekeningsgeheim eenmalig ontvangen.

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

Een webhook-abonnement bijwerken, inschakelen of pauzeren.

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

Een webhook-abonnement verwijderen.

scope: webhooks:write
GET/export

Een geversioneerde export van de werkruimteconfiguratie downloaden, zonder referenties, geheimen, gebeurtenisgeschiedenis of herbouwbare artefacten.

scope: exports:read

Hulp nodig?

Ons engineering team is er om u te helpen met uw integratie.

Praat met support