API Documentation

X-API-Key: your_api_key_here

&api_key=your_api_key_here

https://stagemonitor.app/api/

wss://stagemonitor.app:8080

{ "type": "subscribe", "projectId": "YOUR_PROJECT_ID", "role": "viewer" // or "admin" for sending updates }

const PROJECT_ID = 'abc123def456'; class StagemonitorClient { constructor(projectId, role = 'viewer') { this.projectId = projectId; this.role = role; this.ws = null; this.reconnectInterval = 5000; } connect() { this.ws = new WebSocket('wss://stagemonitor.app:8080'); this.ws.onopen = () => { console.log('Connected to Stagemonitor'); this.subscribe(); }; this.ws.onmessage = (event) => { const data = JSON.parse(event.data); this.handleMessage(data); }; this.ws.onclose = () => { console.log('Disconnected, reconnecting...'); setTimeout(() => this.connect(), this.reconnectInterval); }; this.ws.onerror = (error) => { console.error('WebSocket error:', error); }; } subscribe() { this.ws.send(JSON.stringify({ type: 'subscribe', projectId: this.projectId, role: this.role })); } handleMessage(data) { switch (data.type) { case 'update': console.log('Update received:', data.updateType, data.value); // Handle different update types if (data.updateType === 'countdown') { this.onCountdownUpdate(data.value); } else if (data.updateType === 'note') { this.onNoteUpdate(data.value); } else if (data.updateType === 'program') { this.onProgramUpdate(data.value); } break; case 'pong': // Connection alive break; } } onCountdownUpdate(value) { console.log('Countdown:', value); } onNoteUpdate(value) { console.log('Note:', value); } onProgramUpdate(value) { console.log('Program updated:', value); } // Keep connection alive startPing() { setInterval(() => { if (this.ws.readyState === WebSocket.OPEN) { this.ws.send(JSON.stringify({ type: 'ping' })); } }, 30000); } } // Usage const client = new StagemonitorClient(PROJECT_ID); client.connect(); client.startPing();

import asyncio import websockets import json PROJECT_ID = "abc123def456" async def connect_to_stagemonitor(): uri = "wss://stagemonitor.app:8080" async with websockets.connect(uri) as ws: # Subscribe to project await ws.send(json.dumps({ "type": "subscribe", "projectId": PROJECT_ID, "role": "viewer" })) print("Subscribed to project") # Listen for updates async for message in ws: data = json.loads(message) if data["type"] == "update": print(f"Update: {data['updateType']} = {data['value']}") elif data["type"] == "pong": pass # Connection alive # Run the client asyncio.run(connect_to_stagemonitor())

# Button for 5 minute countdown (public endpoint) https://stagemonitor.app/api/countdown/?id=YOUR_PROJECT_ID&hh=0&mm=5&ss=0 # Button for 10 minute countdown https://stagemonitor.app/api/countdown/?id=YOUR_PROJECT_ID&hh=0&mm=10&ss=0 # Toggle pause https://stagemonitor.app/api/countdown/pause.php?id=YOUR_PROJECT_ID # Set message "LIVE" https://stagemonitor.app/api/note/?id=YOUR_PROJECT_ID¬e=LIVE # Clear message https://stagemonitor.app/api/note/?id=YOUR_PROJECT_ID¬e= # Add 5 minutes (requires API key in header) URL: https://stagemonitor.app/api/countdown/add.php?id=YOUR_PROJECT_ID&min=5 Header: X-API-Key: YOUR_API_KEY # Complete current entry (requires API key) URL: https://stagemonitor.app/api/program/complete.php?id=YOUR_PROJECT_ID Header: X-API-Key: YOUR_API_KEY

# Simple GET request buttons work for public endpoints # For authenticated endpoints, use the "HTTP Request" action with custom headers URL: https://stagemonitor.app/api/countdown/add.php?id=YOUR_PROJECT_ID&min=5 Method: GET Headers: X-API-Key: YOUR_API_KEY

import requests import time class StagemonitorAPI: """Complete Stagemonitor API client""" def __init__(self, project_id, api_key=None): self.project_id = project_id self.api_key = api_key self.base_url = "https://stagemonitor.app/api" def _get(self, endpoint, params=None, auth_required=False): """Make a GET request""" if params is None: params = {} params["id"] = self.project_id headers = {} if auth_required and self.api_key: headers["X-API-Key"] = self.api_key response = requests.get(f"{self.base_url}/{endpoint}", params=params, headers=headers) return response def _post(self, endpoint, params=None, data=None, json_data=None): """Make a POST request (always authenticated)""" if params is None: params = {} params["id"] = self.project_id headers = {"X-API-Key": self.api_key} if self.api_key else {} if json_data: headers["Content-Type"] = "application/json" response = requests.post( f"{self.base_url}/{endpoint}", params=params, headers=headers, data=data, json=json_data ) return response # Countdown methods def set_countdown(self, hours, minutes, seconds): return self._get("countdown/", {"hh": hours, "mm": minutes, "ss": seconds}).json() def get_countdown(self): return self._get("countdown/get.php").text def add_time(self, minutes): return self._get("countdown/add.php", {"min": minutes}, auth_required=True).json() def toggle_pause(self): return self._get("countdown/pause.php").json() # Note methods def set_note(self, note): return self._get("note/", {"note": note}).json() def get_note(self): return self._get("note/get.php").text # Program methods def get_program(self): return self._get("program/get.php").json() def update_entry(self, entry_id, **updates): return self._post("program/update.php", {"entry_id": entry_id}, data=updates).json() def complete_entry(self): return self._get("program/complete.php", auth_required=True).json() def reorder_program(self, active_order, completed_order=None): data = {"activeOrder": active_order} if completed_order: data["completedOrder"] = completed_order return self._post("program/order.php", json_data=data).json() # Monitor methods def get_monitor_data(self): return self._get("monitor/data.php").json() def get_connections(self): return self._get("connections/").json() # Usage example if __name__ == "__main__": api = StagemonitorAPI( project_id="abc123def456", api_key="your_api_key_here" ) # Set 10 minute countdown api.set_countdown(0, 10, 0) # Set note api.set_note("Welcome!") # Get current status data = api.get_monitor_data() print(f"Current: {data['activeEntry']['name']}") print(f"Countdown: {api.get_countdown()}") # Add 5 minutes (requires API key) api.add_time(5) # Complete current entry (requires API key) api.complete_entry()

// JavaScript async function safeApiCall(url, options = {}) { try { const response = await fetch(url, options); if (!response.ok) { const error = await response.json(); throw new Error(error.error || `HTTP ${response.status}`); } return await response.json(); } catch (error) { console.error('API Error:', error.message); throw error; } } // Python def safe_api_call(url, **kwargs): try: response = requests.get(url, **kwargs) response.raise_for_status() return response.json() except requests.exceptions.HTTPError as e: error_data = e.response.json() print(f"API Error: {error_data.get('error', str(e))}") raise