Documentazione

Documentazione API Spectra

Il riferimento tecnico della REST API di Spectra: integra organizzazioni, modelli 3D e viewer olografici nelle tue applicazioni. Sono documentati gli endpoint usabili con un token utente (e quelli pubblici); gli endpoint interni protetti da backend API key non sono inclusi.

L'API è REST su HTTP: corpi e risposte in JSON (salvo upload binari e immagini), autenticazione tramite token utente nell'header Authorization: Bearer. La tua applicazione dialoga unicamente con l'API Spectra: è lei a orchestrare i servizi interni (autenticazione, risorse/storage, controller e pairing dei viewer).

API server

https://api.spectraholo.it

Tutti gli endpoint sotto /v1/….

Auth server

https://auth.spectraholo.it

Solo il login, per ottenere il token.

Architettura

La tua app parla SOLO con l'API Spectra (REST, token Bearer). L'API orchestra i servizi interni.

Per iniziare in 2 passi

Accedi come utente della tua organizzazione per ottenere un token, poi usalo come Bearer su ogni chiamata all'API. Il token dura 7 giorni.

1 · Ottieni un token (login)

POST https://auth.spectraholo.it/v1/organization/{orgId}/user/login

{
  "email": "mario.rossi@azienda.it",
  "password": "Password-2026!"
}

# → { "success": true, "token": "…", "sessionId": 12, "user": { "id": "…" } }

2 · Chiama l'API con il token

GET https://api.spectraholo.it/v1/organization/{orgId}
Authorization: Bearer <token>

Come funziona l'autenticazione

Ottieni un token con il login presso l'Auth server, poi usalo come Bearer verso l'API.

Cosa è documentato qui

Questo riferimento copre gli endpoint chiamabili con un token utente (Bearer) e quelli pubblici. Gli endpoint riservati ai sistemi interni (protetti da backend API key) e quelli del superadmin di piattaforma non sono inclusi, perché non destinati all'uso da parte di applicazioni esterne.

Sezioni consigliate

Da dove partire per integrare Spectra nella tua applicazione.

Convenzioni & erroriIndirizzi base, codici di stato e livelli di authority.AutenticazioneOttieni un token di sessione e usalo come Bearer.OrganizzazioneProfilo, piano e logo della tua organizzazione.Membri & utentiCrea e gestisci gli utenti dell'organizzazione.Modelli 3DCarica, elenca ed elimina i modelli olografici.ViewerAccoppia i display e decidi cosa mostrano.

SuccessivoConvenzioni & errori