WEBSOCKET API

Real-time bidirectional communication for instant updates

Instant, Reliable Updates

The Guardian-X WebSocket API provides real-time, bidirectional communication between clients and our servers, ensuring immediate delivery of critical updates.

When seconds matter, polling isn't fast enough. Our WebSocket infrastructure delivers situation updates, status changes, and alerts the moment they occur.

Sub-Second Delivery

Messages delivered in milliseconds, not seconds

Bidirectional

Send and receive on the same connection

Secure (WSS)

TLS-encrypted WebSocket connections

Real-Time Events

Subscribe to the events that matter to your integration

Situation Events

  • Situation activated
  • Situation updated
  • Situation resolved
  • All-clear issued

Status Events

  • User status changed
  • Check-in received
  • Location updated
  • Response submitted

Alert Events

  • Duress activated
  • Priority alert sent
  • Broadcast message
  • Acknowledgment received

Presence Events

  • User online/offline
  • Device connected
  • Session started
  • Connection quality

Message Events

  • New message received
  • Message read
  • Typing indicator
  • Thread updated

System Events

  • Configuration changed
  • Maintenance scheduled
  • Service status
  • Rate limit warnings

Technical Overview

The Guardian-X WebSocket API uses industry-standard protocols and patterns for reliable real-time communication.

Protocol WebSocket (RFC 6455)
Security WSS (TLS 1.3)
Message Format JSON
Authentication Token-based
Heartbeat 30-second ping/pong
Reconnection Automatic with backoff

Connection Flow

  1. Authenticate

    Obtain a session token via REST API

  2. Connect

    Establish WSS connection with token

  3. Subscribe

    Subscribe to relevant event channels

  4. Receive & Send

    Process incoming events, send messages

  5. Maintain

    Handle heartbeats and reconnection

WebSocket API Access

Complete WebSocket API documentation, including message schemas, event types, and client libraries, is available to Guardian-X customers.

Full Protocol Documentation Client Libraries Code Examples Testing Tools

Need WebSocket Access?

Contact our team to discuss your real-time integration requirements.

Contact Us