Desks Professional e superiori
Se stai creando un'integrazione con deskbird, la nostra Public API ti permette di accedere e gestire dati come prenotazioni, utenti, gruppi, risorse, pianificazione e altro ancora.
👉 Per la documentazione tecnica completa, visita il nostro Developer Hub:
https://developer.deskbird.com
1. Casi d'uso disponibili
Con le API di deskbird puoi collegare i dati di prenotazione e presenza con i tuoi strumenti per il luogo di lavoro già esistenti, automatizzare i flussi di lavoro, creare dashboard personalizzate e ridurre il lavoro manuale. Qui sotto trovi alcuni esempi popolari che i clienti usano per ottenere subito valore operativo e migliorare l'esperienza dei dipendenti.
- Integrazione del controllo accessi: Concedi (e rimuovi) automaticamente l'accesso a edifici o zone in base alle prenotazioni di postazioni o sale riunioni, così i dipendenti hanno l'accesso giusto al momento giusto senza liste manuali.
- Automazione della prenotazione del parcheggio: Rilascia o effettua automaticamente il check-in delle prenotazioni tramite scansione badge o dati HRIS.
- Segnaletica digitale & dashboard per l'ufficio: Mostra la disponibilità in tempo reale e "chi è in ufficio oggi" su schermi o pagine intranet, così i team possono pianificare meglio le giornate in ufficio e trovare rapidamente uno spazio.
- Pulizie e servizi su richiesta: Usa i dati di utilizzo reale (ad esempio, prenotazioni con check-in effettuato) per pulire e servire solo le aree effettivamente utilizzate, riducendo sprechi e concentrando gli sforzi dove servono davvero.
- Analisi dei no-show / ghost booking: Analizza i pattern tra prenotazioni e check-in per individuare i no-show e la capacità inutilizzata, e usa questi dati per migliorare la pianificazione degli spazi e le regole di prenotazione.
- Widget "Trova il mio team": Offri una semplice visualizzazione della presenza del team su strumenti come intranet o piattaforme di collaborazione, così i dipendenti possono vedere quando i colleghi saranno in presenza.
- Analisi avanzate: Collega strumenti BI come PowerBI o Looker per analizzare i trend di utilizzo e occupazione.
💡 Nota: Questi sono solo alcuni esempi. Se ci racconti la tua configurazione e cosa vuoi ottenere, saremo felici di discutere le tue esigenze specifiche e aiutarti a trovare la soluzione di integrazione migliore.
2. Endpoint disponibili
Per gli schemi di richiesta/risposta ed esempi, consulta il Developer Hub.
Regole di rilevamento degli uffici: l'endpoint Lists company network configurations restituisce le regole di rete che la tua azienda utilizza per il rilevamento degli uffici in deskbird intelligence, così puoi collegarle ai tuoi strumenti. I risultati possono essere filtrati per ufficio e sono caricati a pagine. Ogni regola mostra anche con quale altro ufficio è in conflitto, incluso il segnale e il valore coinvolti. Una chiave API restituisce solo i dati della propria azienda. Per esportare invece le stesse regole come file CSV, vedi Configurazione del rilevamento degli uffici e della rete per deskbird Dock.
3. Come iniziare
Tutta la documentazione tecnica, i dettagli sull'autenticazione e i riferimenti agli endpoint sono disponibili nel nostro Developer Hub. Troverai anche esempi di payload, codici di errore e guide all'integrazione.
Per creare una chiave API, vai su Admin > Azienda: Chiavi API e clicca su Genera chiave (solo i Global Admin possono generare chiavi). Nella finestra Genera chiave, inserisci un Nome (nome del progetto), seleziona API o SCIM, scegli una Scadenza (1 anno, 2 anni, 3 anni o Nessuna scadenza), poi clicca su Genera chiave.
La nuova chiave apparirà nell'elenco, con un'anteprima della chiave e dettagli come Creato da, Creato il, Ultimo utilizzo e Scade il.
Puoi eliminare le chiavi usando l'icona del cestino — questa azione non può essere annullata.
💡 Nota: Se la tua azienda utilizza già la sincronizzazione HRIS per il provisioning utenti, non puoi creare chiavi SCIM.
4. Gestione delle chiavi API
I Global Admin possono gestire l'intero ciclo di vita delle chiavi API pubbliche, inclusa la creazione, le impostazioni di scadenza e il monitoraggio.
Nessun limite alle chiavi API
Non c'è alcun limite al numero di chiavi API pubbliche che puoi generare. Creane quante ne servono per le tue integrazioni.
Impostazioni di scadenza
Quando generi una chiave, puoi impostare la sua scadenza su uno dei seguenti periodi:
- 1 anno
- 2 anni
- 3 anni
- Nessuna scadenza
Email di promemoria scadenza
deskbird invia automaticamente email di promemoria prima che una chiave API scada:
- 3 mesi prima della scadenza
- 2 settimane prima della scadenza
Il promemoria viene inviato alla persona che ha creato la chiave, finché il suo account è ancora attivo. Se l'account del creatore non è più attivo, l'email viene inviata a tutti i Global Admin.
5. Serve aiuto?
Hai in mente un caso d'uso specifico? Non sei sicuro che qualcosa sia possibile?
👉 Scrivi a support@deskbird.com. Siamo felici di aiutarti a definire l'integrazione.