Welcome to Roboscope 2 API

Complete REST API for managing spatial work sessions with AR markers, real-time presence tracking, and collaborative editing features.

🚀 Quick Start

1. Select a server (localhost or production) from the dropdown above
2. Explore endpoints using the left navigation
3. Try it out using the interactive "TRY" buttons

✨ Key Features

• Spaces - Manage physical/virtual environments
• Work Sessions - Track inspection/repair sessions with marker counts
• Markers - 3D AR markers with quad coordinates (p1-p4)
• Events - Complete audit trail of all operations
• Presence - Real-time user presence tracking (30s TTL)
• Locks - Distributed session locking (5-30s TTL)

🔒 Optimistic Locking

Work Sessions and Markers use optimistic locking via the version field:

// 1. Get current version
GET /work-sessions/{id}
// Response: { "version": 1, ... }

// 2. Update with version
PATCH /work-sessions/{id}
{ "status": "done", "version": 1 }

// 3. If version mismatch → 409 Conflict

📊 marker_count Field

All work session responses include a marker_count field showing the number of markers in that session. This is calculated server-side for optimal performance.

🔗 Resources

• GitHub Repository
• Production Health Check

📚 Integration Guides

• Next.js Integration Guide
• Redis Features Documentation