High-level call patterns

This page shows the most common “happy path” call pattern for integrating the widget with your backend and the SavageTech API.

Use it as a reference for integrators and for implementation reviews.

Swimlane diagram (recommended pattern)

Notes for integrators

• Never call POST /api/v1/auth/websocket-tokens from the browser. Keep x-client-secret server-side.
• Put all “who is the player?” logic in your own backend/front-end (your identifiers, your sessions).
• Use Widget Integration for copy/paste code and troubleshooting.