L'API aperta di Guesty è un'API REST che offre un modo versatile per integrare i tuoi sistemi con il tuo account Guesty. Utilizza token di accesso OAuth 2.0 per autenticare le richieste, garantendo un'autorizzazione sicura e affidabile. OAuth 2.0 è un metodo di autorizzazione sicuro e standard di settore che garantisce l'accesso sicuro ai dati utente tramite token codificati, senza esporre l'identità o le credenziali dell'utente. Per ulteriori informazioni, consulta la documentazione API e i dettagli sui limiti di frequenza delle chiamate API di Guesty.
L'API aperta di Guesty consente a te e al tuo team di creare e connettere strumenti personalizzati su misura per le vostre esigenze. Potete generare ID client e segreti client (credenziali client) univoci per ogni servizio, strumento o sistema integrato. Inoltre, le nostre statistiche forniscono dati in tempo reale sull'utilizzo dell'API, aiutandovi a monitorare e ottimizzare le vostre integrazioni.
Segui le istruzioni riportate di seguito per registrare una nuova applicazione. Puoi eliminarla in qualsiasi momento.
Nota:
È possibile creare fino a cinque (5) applicazioni Open API OAuth.
Creare le credenziali OAuth
Quando registri l'applicazione, riceverai un ID client e un segreto client, che potrai utilizzare per effettuare chiamate API che richiedono l'identificazione dell'applicazione.
Passo dopo passo:
- Accedi al tuo account Guesty.
- Nel menu di navigazione laterale, fai clic su
Integrazioni, quindi apri il menu a tendina e seleziona Strumenti per sviluppatori. - Seleziona le applicazioni OAuth.
- In alto a destra, fai clic su Nuova applicazione.
- Inserisci il nome e la descrizione dell'applicazione e fai clic su Salva. Questi campi sono obbligatori.
-
Fai clic sull'icona
accanto al tasto corrispondente e incollalo in un luogo sicuro per riferimento futuro.Importante:
Il tuo client secret è visibile solo la prima volta che vi accedi, dopodiché Guesty lo oscura per motivi di sicurezza.
Elimina la coppia di chiavi API
Per eliminare un'applicazione, insieme al relativo ID client e al segreto client, fare clic su 
a destra dell'applicazione pertinente e confermare l'azione nella finestra a comparsa. Questa azione è irreversibile.
Utilizzo della dashboard delle statistiche delle Open API di Guesty
La dashboard delle statistiche delle API aperte di Guesty fornisce una panoramica dettagliata dell'utilizzo e delle prestazioni delle API della tua applicazione. Questo strumento ti consente di monitorare metriche chiave come i tassi di successo delle richieste, gli errori del client e le soglie di rate limit. Ogni sezione della dashboard offre informazioni preziose per aiutarti a ottimizzare le chiamate API, risolvere i problemi e garantire una perfetta integrazione con applicazioni di terze parti.
Segui le istruzioni per accedere alla dashboard delle API aperte di Guesty.
Passo dopo passo:
- Accedi al tuo account Guesty.
- Nel menu di navigazione laterale, fai clic Integrazioni per aprire il menu a tendina.
- Seleziona Statistiche OAuth.
Utilizzo dei webhook rivolti ai clienti di Guesty
La sezione webhook di Guesty offre un'interfaccia centralizzata per gestire i webhook, visualizzare l'attività e risolvere i problemi in modo efficace.
Nota:
La dashboard dei webhook al momento non supporta la gestione delle sottoscrizioni ai webhook. È possibile iscriversi e gestire i webhook solo tramite l'API aperta. Per gestire le sottoscrizioni ai webhook, consultare la guida all'API dei webhook.
Punti terminali
Monitorare regolarmente gli endpoint per garantire bassi tassi di errore e risolvere tempestivamente eventuali problemi. Visualizzare e gestire tutti gli URL webhook attivi e i rispettivi tassi di errore.
Visualizza i log per un URL specifico
Fai clic sull'URL di un webhook per accedere a informazioni dettagliate, tra cui il segreto di firma (la chiave utilizzata per autenticare le richieste da Guesty al tuo endpoint) e la possibilità di riprodurre i singoli eventi del webhook.