L'API Sixto: le stesse azioni e gli stessi permessi del team
L'API Sixto espone le stesse azioni dell'app, come attività, record, report e messaggi, tramite chiavi che hanno solo i permessi che assegni loro. Ogni chiamata viene registrata nel log attività della chiave. Una chiave può verificare la propria identità e ciò che è autorizzata a fare. Le azioni delicate attendono la conferma di una persona.
Disponibile. Un'API REST versionata con chiavi a permessi limitati copre prenotazioni, ospiti, attività, finanza, check-in, serrature, canali e altro.
I tuoi strumenti, accesso limitato
Le chiavi API ottengono solo i permessi che scegli
Cosa fa
Scopri cosa viene trasferito e cosa rimane dov’è
Le frecce indicano la direzione dei dati rispetto a Sixto.
Ampia copertura
Attività, prenotazioni, ospiti, recensioni, messaggi, check-in, conformità, serrature, canali, fatture elettroniche, banca e libro contabile, confronti di mercato, ricerca e impostazioni.
Chiavi a permessi limitati da un unico catalogo
Le chiavi usano lo stesso catalogo di permessi delle persone. Per modificare i permessi, un titolare crea una chiave sostitutiva e revoca la vecchia. La revoca ha effetto alla chiamata successiva.
Informazioni sulle proprie capacità
Chiedi all'API chi sei e cosa puoi fare (whoami e capabilities), compresi i permessi richiesti da ogni percorso.
Nuovi tentativi sicuri e registro attività
Ogni operazione di scrittura documenta la propria identità per i nuovi tentativi, come external_id o l'intestazione Idempotency-Key, e restituisce 409 se la stessa identità viene riutilizzata con contenuti diversi. Ogni richiesta ha un ID e compare nel registro attività.
Limiti equi
Ogni chiave ha un proprio limite, per impostazione predefinita 600 richieste al minuto, così una chiave molto usata non rallenta le altre. GET /api/v1/capabilities riporta il valore attuale.
Preferisci un’app di IA? Usa MCP
Oltre all’API REST, Sixto offre un server MCP per le app di IA con accesso OAuth, disattivato finché un utente con ruolo Titolare o Responsabile dell’organizzazione non lo abilita, e un MCP pubblico di sola lettura per la documentazione.
- Indirizzo del server
https://holasixto.com/mcp- MCP della documentazione
https://holasixto.com/mcp/docsPubblico e di sola lettura. Cerca nella documentazione di Sixto e non vede mai i dati della tua organizzazione.
Come funziona
- 01
Un titolare crea una chiave in Impostazioni e seleziona i permessi necessari. La chiave viene mostrata una sola volta.
- 02
Inviala come token Bearer. Chiama whoami e capabilities per vedere cosa può fare la chiave.
- 03
Leggi o scrivi tramite gli endpoint. Le operazioni di scrittura seguono gli stessi controlli dell'app.
- 04
Controlla le chiamate nella vista delle attività API e revoca una chiave quando vuoi.
Cosa viene sincronizzato
Domande frequenti
Esiste una guida per sviluppatori?
Sì. Il riferimento OpenAPI 3.1 si trova in /api/v1/openapi.json e la guida client in /api/v1/guide.json. Ogni operazione mostra x-contract-status: complete indica un contratto verificato; unsupported indica un percorso ancora disponibile ma fuori dalla superficie client supportata. Un server di documentazione in sola lettura è in /mcp/docs.
Per conto di chi agisce una chiave?
Una chiave agisce per l'organizzazione entro i propri permessi. Non ha un elenco di strutture proprio e non eredita i limiti sulle strutture della persona che l'ha creata. Quando Sixto inoltra la richiesta di una persona con una delega Sixto-On-Behalf-Of, si applicano anche i permessi e i limiti attuali di quella persona sulle strutture.
Come modifico i permessi di una chiave?
Crea una chiave sostitutiva con i permessi desiderati, imposta il tuo strumento per usarla e revoca la vecchia. Le chiavi esistenti non possono essere modificate. Una chiave revocata viene rifiutata alla chiamata successiva.
Cosa significano 422 e 429?
422 indica un errore di convalida: leggi l'oggetto errors per campo, correggi i dati e riprova. 429 indica che la chiave ha raggiunto il proprio limite: attendi il numero di secondi nell'intestazione Retry-After, poi riprova rallentando progressivamente. Conserva X-Request-Id per trovare la chiamata nel registro attività.
Una chiave può sbloccare una porta?
No. Lo sblocco remoto non è mai disponibile tramite l'API.
L'API è versionata?
Sì, si trova sotto /api/v1.