.png)
Sisense Integration Guide
Integrate Sisense analytics, dashboards, data models, users, and groups with enterprise systems through REST APIs, scheduled workflows, and selected notification mechanisms.
Sisense integration options at a glance
Sisense primarily integrates through REST APIs covering platform administration, dashboards, widgets, users, groups, data models, and related analytics operations. Token-based authentication is the usual server-to-server pattern, with permissions governed by the Sisense account and deployment. Selected products or configurations may provide notification or alert-style outbound mechanisms, but universal webhooks are not confirmed. Model refreshes and exports may require asynchronous status polling, while direct access to internal Sisense storage should not be assumed. Martini can consume these APIs, schedule incremental synchronization, receive applicable callbacks, map and validate responses, orchestrate refresh jobs, and expose controlled APIs for downstream applications.
Common Sisense integration patterns
Common Sisense data objects used in integrations
Authentication and security considerations
Token-based API access
Sisense REST integrations commonly authenticate against a Sisense authentication endpoint and use a bearer token for subsequent requests. The exact endpoint, token lifetime, and permissions depend on the deployment and version.
Permissions and least privilege
API access follows the Sisense user's permissions for dashboards, widgets, data models, users, groups, and administrative resources. Use a dedicated account with only the permissions required by each workflow.
Secrets and sensitive data
- Store credentials, tokens, and environment-specific endpoints in Martini secrets or secure configuration.
- Do not embed credentials in workflow definitions or log bearer tokens.
- Treat exported analytical content as potentially sensitive and apply retention and access controls.
- Verify enterprise SSO and identity-provider arrangements separately from the server-to-server API authentication flow.
Operational considerations for Sisense integrations
Version and schema variation
Sisense API paths, authentication behavior, object models, and administrative operations can differ across Cloud, Linux, Windows, and older deployments. Version mappings and response validation should be maintained explicitly.
Pagination and throttling
Collection endpoints should use explicit pagination and termination conditions. Respect deployment-specific throttling and avoid large metadata scans during model refresh activity.
Long-running operations
Refreshes and exports may require polling, bounded retries, exponential backoff where appropriate, timeout limits, and a final failed state for operations that do not complete.
Idempotency and observability
- Use stable Sisense identifiers and compare current state before updates.
- Capture operation identifiers, response status, correlation information, and object identifiers.
- Handle inaccessible dashboards or widgets as per-object failures rather than silently dropping them.
- Keep passwords, bearer tokens, and sensitive analytical content out of logs.
Why use Martini instead of scripts or point-to-point integrations?
Orchestration beyond a script
Martini coordinates authentication, pagination, transformation, conditional routing, asynchronous polling, downstream delivery, and failure handling in maintainable workflows rather than scattering logic across point-to-point scripts.
Reusable integration assets
Teams can expose controlled APIs, reuse workflow logic, version mappings, and apply consistent business rules across dashboard metadata, model refresh, export, and access-synchronization processes.
Operational control
- Schedule incremental synchronization and coordinate source loads with Sisense refreshes.
- Centralize retries, timeout handling, validation, and per-object error reporting.
- Keep credentials and deployment configuration separate from implementation logic.
- Provide a stable API façade when downstream applications should not depend directly on Sisense version-specific endpoints.