API v1.0

API per sviluppatori

Integra SignaGenius nei tuoi flussi di lavoro esistenti. La nostra API REST ti permette di gestire programmaticamente i membri del team, attivare sincronizzazioni e ottenere analitiche in tempo reale.

Autenticazione

Tutte le richieste API devono essere autenticate utilizzando un token Bearer. Puoi generare le tue chiavi API in Admin Panel > Impostazioni > Sviluppatori.

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

Endpoints

GET/users

Elenca tutti i membri del team e lo stato della loro firma.

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

Crea un utente gestito dello spazio di lavoro.

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

Recupera un utente gestito nell'ambito del tenant.

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

Aggiorna i campi del profilo supportati o lo stato dell'account.

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

Disattiva un utente in modo reversibile conservandone la cronologia di controllo.

ambito: users:write
POST/users/batch

Crea, aggiorna o disattiva fino a 100 utenti con esiti per riga e ripetizione idempotente.

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

Elenca i 200 artefatti di firma generati più recenti.

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

Elenca le richieste di modifica del profilo soggette a governance.

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

Recupera analitiche sui clic dei link per un intervallo di tempo specifico.

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

Elenca i pubblici di campagna riutilizzabili e i membri risolti.

ambito: audiences:read
POST/audiences

Crea o sostituisci in modo idempotente un pubblico gestito via API.

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

Recupera un pubblico con i suoi membri risolti.

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

Sostituisci un pubblico e l'intero elenco dei suoi membri.

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

Elimina un pubblico riutilizzabile.

ambito: audiences:write
GET/webhooks

Elenca le sottoscrizioni webhook firmate senza i relativi segreti.

ambito: webhooks:write
POST/webhooks

Crea una sottoscrizione e ricevi una sola volta il suo segreto di firma.

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

Aggiorna, attiva o metti in pausa una sottoscrizione webhook.

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

Elimina una sottoscrizione webhook.

ambito: webhooks:write
GET/export

Scarica un'esportazione versionata della configurazione dello spazio di lavoro, senza credenziali, segreti, cronologia degli eventi o artefatti ricostruibili.

ambito: exports:read

Serve aiuto?

Il nostro team di ingegneri è qui per aiutarti con la tua integrazione.

Parla con il supporto