Sviluppatori
A cosa serve
Sezione intitolata “A cosa serve”L’area Sviluppatori serve se un tecnico deve collegare un sistema esterno a Wine Suite. Se in cantina non gestite integrazioni custom, potete ignorarla.
Un webhook è un avviso automatico: quando succede qualcosa (nuova prenotazione, ordine pagato…) Wine Suite chiama un URL che gli avete indicato. Un’API Key è una coppia di chiavi (pubblica e segreta) con cui un programma si autentica. I metadata sulle esperienze sono campi extra per quegli stessi collegamenti. La chiave segreta va conservata come una password: se la perdete o la condividete, va rigenerata. I cataloghi REST (Integration v2–v4, OCTO, Order Import) sono nel menu Avanzate; il più usato è Integration v2.
Come fare
Sezione intitolata “Come fare”-
Apri Impostazioni → Sviluppatori solo se stai seguendo le indicazioni di uno sviluppatore o di un connettore ufficiale.
-
Per un webhook: indica un nome chiaro, l’URL, l’evento e il metodo (di solito POST), poi salva. Fate una prova e controllate che il sistema esterno riceva la chiamata.
-
Per una API Key: genera la chiave, copia API Secret in un gestore di segreti (non in una email in chiaro) e chiudi. I metadata si compilano sulla scheda esperienza quando il connettore lo richiede.
La schermata, passo dopo passo
Sezione intitolata “La schermata, passo dopo passo”Qui sotto la pagina è raccontata nello stesso ordine in cui la percorri in Wine Suite: prima quello che vedi in alto, poi i filtri, i riquadri e i dettagli. Ogni figura è lo screenshot della bozza originale, messo accanto al pezzo di interfaccia che illustra.
Sviluppatori
Sezione intitolata “Sviluppatori”
Sviluppatori
La sezione Sviluppatori permette di integrare software esterni con la piattaforma tramite Webhooks e API Key.
Qui trovi Webhooks (consentono di ricevere notifiche automatiche quando si verificano eventi nella piattaforma. Per ogni webhook è possibile configurare:), URL (indirizzo che riceverà la notifica), Event Name (evento che attiva l’invio) e Method (metodo HTTP utilizzato (es. POST)). Poi Headers (intestazioni HTTP aggiuntive da inviare con la richiesta).
Headers
API Key — Consentono di autenticare applicazioni esterne per utilizzare le API della piattaforma.
Per ogni chiave sono disponibili. Qui trovi Nome (nome identificativo della chiave), API Key (identificativo pubblico utilizzato per autenticare le richieste) e API Secret (chiave privata da conservare in modo sicuro e utilizzare insieme alla API Key).
API Secret
Se qualcosa non torna
Sezione intitolata “Se qualcosa non torna”Le domande su API e webhook sono nella FAQ Funzioni avanzate.