API v1.0

API pour Développeurs

Intégrez SignaGenius dans vos flux existants. Notre API REST vous permet de gérer les membres de l'équipe, déclencher des synchronisations et obtenir des statistiques en temps réel par programmation.

Authentification

Toutes les requêtes API doivent être authentifiées à l'aide d'un jeton Bearer. Vous pouvez générer vos clés API dans Admin Panel > Paramètres > Développeurs.

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

Endpoints

GET/users

Lister tous les membres de l'équipe et le statut de leur signature.

périmètre : users:read?limit=1...200?offset=0...1000000
POST/users

Créer un utilisateur géré de l'espace de travail.

périmètre : users:write
GET/users/{id}

Récupérer un utilisateur géré limité au locataire.

périmètre : users:read
PATCH/users/{id}

Mettre à jour les champs de profil pris en charge ou le statut du compte.

périmètre : users:write
DELETE/users/{id}

Désactiver un utilisateur de façon réversible en conservant son historique d'audit.

périmètre : users:write
POST/users/batch

Créer, mettre à jour ou désactiver jusqu'à 100 utilisateurs, avec un résultat par ligne et une reprise idempotente.

périmètre : users:writeheader: Idempotency-Key
GET/signatures

Lister les 200 artefacts de signature générés les plus récents.

périmètre : signatures:read?user_id
GET/change-requests

Lister les demandes de modification de profil soumises à gouvernance.

périmètre : requests:read?status=pending|approved|rejected
GET/analytics

Récupérer les statistiques de clics sur les liens pour une plage de temps spécifique.

périmètre : analytics:read?days=1...365
GET/audiences

Lister les audiences de campagne réutilisables et leurs membres résolus.

périmètre : audiences:read
POST/audiences

Créer ou remplacer de manière idempotente une audience gérée par l'API.

périmètre : audiences:write
GET/audiences/{id}

Récupérer une audience avec ses membres résolus.

périmètre : audiences:read
PUT/audiences/{id}

Remplacer une audience et l'intégralité de ses membres.

périmètre : audiences:write
DELETE/audiences/{id}

Supprimer une audience réutilisable.

périmètre : audiences:write
GET/webhooks

Lister les abonnements webhook signés, sans leurs secrets.

périmètre : webhooks:write
POST/webhooks

Créer un abonnement et recevoir son secret de signature une seule fois.

périmètre : webhooks:write
PATCH/webhooks/{id}

Mettre à jour, activer ou suspendre un abonnement webhook.

périmètre : webhooks:write
DELETE/webhooks/{id}

Supprimer un abonnement webhook.

périmètre : webhooks:write
GET/export

Télécharger un export versionné de la configuration de l'espace de travail, sans identifiants, secrets, historique d'événements ni artefacts reconstructibles.

périmètre : exports:read

Besoin d'aide ?

Notre équipe d'ingénierie est là pour vous aider avec votre intégration.

Parler au Support