API v1.0

API para Desarrolladores

Integra SignaGenius en tus flujos de trabajo existentes. Nuestra API REST te permite gestionar programáticamente miembros del equipo, activar sincronizaciones y obtener analíticas en tiempo real.

Autenticación

Todas las solicitudes a la API deben autenticarse usando un token Bearer. Puedes generar tus claves API en el Panel de Admin > Configuración > Desarrolladores.

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

Endpoints

GET/users

Listar todos los miembros del equipo y el estado de su firma.

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

Crear un usuario gestionado del espacio de trabajo.

ámbito: users:write
GET/users/{id}

Obtener un usuario gestionado dentro del inquilino.

ámbito: users:read
PATCH/users/{id}

Actualizar los campos de perfil admitidos o el estado de la cuenta.

ámbito: users:write
DELETE/users/{id}

Desactivar un usuario de forma reversible conservando su historial de auditoría.

ámbito: users:write
POST/users/batch

Crear, actualizar o desactivar hasta 100 usuarios con resultados por fila y reintento idempotente.

ámbito: users:writeheader: Idempotency-Key
GET/signatures

Listar los 200 artefactos de firma generados más recientes.

ámbito: signatures:read?user_id
GET/change-requests

Listar las solicitudes de cambio de perfil sujetas a gobernanza.

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

Recuperar analíticas de clics en enlaces para un rango de tiempo específico.

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

Listar las audiencias de campaña reutilizables y sus miembros resueltos.

ámbito: audiences:read
POST/audiences

Crear o reemplazar de forma idempotente una audiencia gestionada por API.

ámbito: audiences:write
GET/audiences/{id}

Obtener una audiencia con sus miembros resueltos.

ámbito: audiences:read
PUT/audiences/{id}

Reemplazar una audiencia y la totalidad de sus miembros.

ámbito: audiences:write
DELETE/audiences/{id}

Eliminar una audiencia reutilizable.

ámbito: audiences:write
GET/webhooks

Listar las suscripciones de webhook firmadas sin sus secretos.

ámbito: webhooks:write
POST/webhooks

Crear una suscripción y recibir su secreto de firma una sola vez.

ámbito: webhooks:write
PATCH/webhooks/{id}

Actualizar, activar o pausar una suscripción de webhook.

ámbito: webhooks:write
DELETE/webhooks/{id}

Eliminar una suscripción de webhook.

ámbito: webhooks:write
GET/export

Descargar una exportación versionada de la configuración del espacio de trabajo, sin credenciales, secretos, historial de eventos ni artefactos reconstruibles.

ámbito: exports:read

¿Necesitas ayuda?

Nuestro equipo de ingeniería está aquí para ayudarte con tu integración.

Hablar con Soporte