Risorse per sviluppatori



Aggiunta di Queue-Fair

La sala d'attesa virtuale Queue-Fair è facilmente aggiungibile a un'ampia varietà di piattaforme web e app in pochi minuti. Basta usare uno dei nostri adattatori. Puoi trovare maggiori informazioni sul modo migliore per integrare Queue-Fair con il tuo sistema esistente nella Guida tecnica, o nel Portale Queue-Fair > sezione Aiuto.

L'adattatore lato client

Per i siti web, il modo più semplice per integrarsi con Queue-Fair è quello di aggiungere il tag JavaScript Client-Side Queue-Fair Adapter alle tue pagine. Puoi tranquillamente aggiungere l'adattatore a tutte le pagine del tuo sito e usare le regole di attivazione nel portale Queue-Fair per determinare quali pagine possono lanciare una coda.

Poiché funziona nei browser dei tuoi visitatori, il Client-Side Adapter può essere disabilitato dai visitatori tecnicamente esperti, ma è molto efficace nel prevenire il sovraccarico, poiché solo una minoranza molto piccola di persone tenterà di saltare la coda manomettendo il JavaScript. La maggior parte dei nostri clienti usa il Client-Side Adapter perché è efficace nel prevenire un sito in crash, è semplice da installare e non introduce alcuna dipendenza tra il nostro sistema e il vostro.

Puoi aggiungere un livello di sicurezza sostituendo il tag JavaScript con un Server-Side Adapter, o combinare la flessibilità del JavaScript Adapter con il modello di sicurezza ibrido descritto in questa pagina; entrambi i metodi sono quindi sicuri.

Singola linea di codice

Per aggiungere l'adattatore lato client al tuo sito, basta aggiungere la seguente singola linea di codice al file <head> delle vostre pagine:

Aggiungi la nostra sala d'attesa virtuale al tuo sito con questa singola linea di codice e previeni i crash del sito web

Alcuni clienti aggiungono la parola defer al tag, che fa sì che lo script Adapter venga scaricato in parallelo all'analisi della pagina e che inizi l'esecuzione dello script nel browser del visitatore solo quando la pagina ha finito l'analisi (quindi tipicamente dopo che qualsiasi altro script sulla tua pagina ha finito).

Aggiungere la parola defer può migliorare il Time to First Paint di una piccola frazione di secondo in alcuni casi, ma se scegliete di farlo significa che qualsiasi visitatore che dovrebbe essere in coda vedrà la vostra pagina protetta per una frazione di secondo in più prima di essere mandato in coda.

Google Tag Manager

Forniamo anche il tag adattatore JavaScript tramite Google Tag Manager. Cerca Queue-Fair nella Community Templates Gallery, sotto Add Tag. Si prega di notare che alcuni ad blocker impediscono il download del master gtm.js da Google, il che blocca tutte le operazioni di Google Tag Manager, compresa l'esecuzione dell'adattatore per quei visitatori.Il nostro tag Sala d'attesa virtuale per Google Tag Manager

Repository GitHub

Google Tag Manager

Google Tag Manager

Il repository GitHub per il tag Queue-Fair Virtual Waiting Room Google Tag Manager Client-Side Adapter.

Pagine di coda dinamiche

Tutti i dati che desideri possono essere passati dal tuo sito ai nostri server e alle pagine di coda che i tuoi visitatori vedono utilizzando l'attributo data-queue-fair-extra che è disponibile nel tag JavaScript lato client e nell'implementazione di Google Tag Manager. Contatta il supporto se desideri abilitare le Pagine in coda dinamiche sul tuo account.

Puoi usare questa funzione per personalizzare le pagine della coda al volo. Potete anche usare Queue-Fair per passare i dati che ci inviate con i vostri visitatori al vostro sito quando vengono passati dalla coda, per un ulteriore livello di sicurezza.

Forniamo anche un'API per le pagine di coda dinamiche che utilizza i dati extra per personalizzare qualsiasi aspetto di una pagina di coda, in modo da poter creare una coda per tutto il tuo sito e personalizzarla automaticamente per diversi eventi o prodotti sul tuo sito, senza dover apportare alcuna modifica alle tue pagine di coda nel portale Queue-Fair

.



Wordpress e WooCommerce

Se stai usando un sito basato su Wordpress, come il sistema di carrello della spesa WooCommerce, puoi facilmente aggiungere il tag Client-Side JavasScript Adapter usando il plugin Wordpress Insert Headers & Footers, senza dover modificare nessuno dei tuoi temi o toccare alcun codice Wordpress.

Basta scaricare il plugin Insert Headers & Footers, decomprimerlo nella tua cartella /wp-content/plugins/, attivare il plugin nel menu Plugins, aprire il plugin dal menu Settings, aggiungere il tag a Scripts in Header come mostrato, premere Save in fondo alla pagina, e hai finito!

Il cruscotto del portale Queue-Fair

Adattatore lato client Risorse aggiuntive

L'adattatore lato client è completamente descritto nella guida tecnica. La guida tecnica è disponibile nel portale Queue-Fair > sezione Aiuto, oppure puoi richiederne una copia a noi.


Adattatori lato server

Mentre l'adattatore lato client viene eseguito in JavaScript nei browser dei tuoi visitatori, gli adattatori lato server Queue-Fair vengono eseguiti sul tuo webserver.

Adattatori per server web

Questo significa che il tuo server web può approfittare di ulteriori funzioni di sicurezza per negare l'accesso a persone che non sono state accodate. Questo significa anche che il vostro server web evita il carico di generare e servire pagine contenenti lo script Adapter.

L'aggiunta delle librerie Queue-Fair Server-Side Adapter richiede solo pochi minuti con minime modifiche al codice per attivare ed eseguire l'adattatore.

La maggior parte dei nostri clienti iniziano con l'adattatore JavaScript lato client e passano all'adattatore lato server solo quando c'è un'esigenza aziendale specifica.

Modalità semplice e sicura

Gli adattatori lato server Queue-Fair possono funzionare in modalità semplice o sicura.

In modalità semplice, tutti i visitatori sono inviati ai server Queue-Fair per essere contati, che si sia formata o meno una coda. Quando non c'è una coda, vengono rimandati subito al tuo Web Server, senza vedere una pagina di coda - ma con la firma che serve al tuo Web Server per assicurare che solo le persone che sono state passate dalla coda possano accedere alle tue risorse protette.

In modalità sicura, i visitatori vengono inviati ai server Queue-Fair solo quando c'è una coda. Il tuo server web consulta direttamente i nostri Queue Server per fare questa determinazione. I visitatori vengono comunque firmati digitalmente in modo sicuro, sia che venga mostrata o meno una pagina di coda.

La modalità sicura è raccomandata per le code giornaliere. La modalità semplice è appropriata per un evento a tempo quando ti aspetti migliaia di persone, poiché elimina la latenza dovuta alla chiamata di controllo dal tuo server web ai nostri Queue Server, il che significa che puoi inviare le persone alla coda in modo più efficiente.

Repository GitHub

Adattatore sala d'attesa virtuale PHP') ?>

PHP

Il repository GitHub per l'adattatore lato server della sala d'attesa virtuale Queue-Fair in PHP.

Adattatore di sala d'attesa virtuale Java

Java

Il repository GitHub per il Queue-Fair Virtual Waiting Room Server-Side Adapter per Java, inclusi JBoss e Tomcat.

Adattatore per sala d'attesa virtuale Ruby

Ruby

Il repository GitHub per l'adattatore lato server della sala d'attesa virtuale Queue-Fair in Ruby e (opzionalmente) Rails.

Adattatore per sala d'attesa virtuale Python

Python

Il repository GitHub per l'adattatore lato server della sala d'attesa virtuale Queue-Fair in Python e (opzionalmente) Django.

Adattatore di sala d'attesa virtuale dotNet

.NET

Il repository GitHub per l'adattatore lato server della sala d'attesa virtuale Queue-Fair per .NET, ASP e C#.

Node.js & JavaScript Adattatore di sala d'attesa virtuale

Node.js & JavaScript

Il repository GitHub per l'adattatore lato server della sala d'attesa virtuale Queue-Fair per Node.js e (opzionalmente) Express.



Pagine di coda dinamiche

Come con il Client-Side Adapter, qualsiasi dato che desideri può essere passato dal tuo server web ai nostri server e alle pagine di coda che i tuoi visitatori vedono passando queste informazioni nella chiamata Server-Side Adapter. Questo facilita la Dynamic Queue Page o altre personalizzazioni al volo allo stesso modo - tutte le caratteristiche del Client-Side Adapter sono pienamente supportate. Contatta il supporto se vuoi abilitare le Dynamic Queue Pages sul tuo account.

Adattatore lato server Risorse aggiuntive

I nostri adattatori lato server sono completamente descritti nella guida tecnica. La guida tecnica è disponibile nel portale Queue-Fair > sezione Aiuto, oppure puoi richiederne una copia a noi. Puoi anche trovare maggiori informazioni su ciascuno degli adattatori nel README.md di ogni repository GitHub.


API REST

Queue-Fair dà agli sviluppatori l'accesso a sei moduli API REST. È necessario un account Queue-Fair per utilizzare l'API. Per abilitare l'accesso all'API per il tuo account, contatta il supporto Queue-Fair. I nostri moduli API REST sono conformi agli standard OpenAPI, RFC 7807 e RFC 3339.

La nostra suite di moduli API è completa - tutto ciò che puoi fare nel portale, puoi anche farlo con l'API, eccetto la gestione degli utenti del portale che è esclusa per motivi di privacy.

Ogni modulo API è completamente documentato su api.queue-fair.net, dove troverete anche un'interfaccia Swagger per facilitare l'uso e i test. Per la sicurezza, tutte le chiamate API sono protette dalla crittografia TLS e richiedono una chiave API specifica per il vostro account.

Moduli API

Segnalazione API

Per i rapporti in tempo reale, i rapporti storici e le statistiche aggregate delle code.

API per la gestione delle code

Per creare e modificare programmaticamente le code in tempo reale.

API di gestione dell'account

Per visualizzare e aggiornare le impostazioni dell'account.

API di gestione delle risorse

Per gestire le risorse utilizzate dalle tue pagine in coda servite da Google CDN.

Presentazione API

Per cambiare qualsiasi aspetto dell'HTML delle vostre pagine di coda e l'aggiornamento e la creazione di varianti al volo.

Attivazione API

Per configurare le Regole di attivazione che determinano quali pagine del tuo sito possono attivare una coda, e quale pagina viene mostrata.



Pagine di coda dinamiche

Puoi anche modificare le tue pagine di coda al volo senza dover aggiornare il database usando il portale o l'API di presentazione - Contatta il supporto per ulteriori dettagli e per abilitare le pagine di coda dinamiche sul tuo account.

REST API Risorse aggiuntive

Come richiesto da RFC 7807, puoi trovare la documentazione sui messaggi di errore che possono essere restituiti dai nostri moduli API REST su queue-fair.com/api-error


App native

Queue-Fair ha un ottimo aspetto sui browser mobili così come su desktop e laptop.

Potete anche usare Queue-Fair direttamente nelle vostre app native iOS e Android, e anche nelle app React Native su iOS, Android, Windows e MacOS, per proteggere attività o operazioni ad alta intensità di risorse.

Gli adattatori Queue-Fair App utilizzano un WebClient per mostrare ai vostri utenti visualizzazioni personalizzate della coda quando i vostri servizi sono troppo occupati, con la flessibilità e la facilità d'uso del Queue-Fair Portal.

Puoi mettere in coda gli utenti nella stessa coda dei visitatori del tuo sito web, o impostare una coda separata per gli utenti della tua app - dipende da te.

Proprio come le nostre code basate sul web, il posto di ogni utente viene automaticamente salvato anche se si allontana dalla tua app.

Repository GitHub

iOS, MacOS e adattatore sala d'attesa virtuale Apple

iOS & MacOS

Il repository GitHub per l'adattatore Queue-Fair Virtual Waiting Room iOS e MacOS.

Adattatore per sala d'attesa virtuale Android

Android

Il repository GitHub per l'adattatore della sala d'attesa virtuale Queue-Fair per Android.

React Native App Adattatore sala d'attesa virtuale

React Native

Il repository GitHub per l'adattatore Queue-Fair Virtual Waiting Room per app React Native per Android, iOS, MacOS e Windows.

Notifiche di coda

L'adattatore Queue-Fair semplifica l'invio di notifiche Push agli utenti che non stanno usando la tua app o la tua coda quando viene chiamato il loro turno. Il posto dell'utente nella coda è automaticamente memorizzato in modo persistente dall'adattatore nella tua app. Se l'utente si allontana dalla tua app, la tua app dice al tuo server di Push Notification che deve essere inviata una notifica, inviando le informazioni sulla posizione della coda memorizzate come parte del messaggio al tuo server di Push Notification.

È la stessa tecnologia che usiamo per la nostra app per i consumatori WeQ4U, che ha avuto circa 2 milioni di download solo nel Regno Unito.

Il vostro server di notifica Push consulta periodicamente l'API di stato Queue-Fair per interrogare la posizione della coda attualmente servita. Quando questa è maggiore della posizione della coda di un particolare utente, è il momento di inviare la notifica a quell'utente. Se l'utente ritorna nella coda o viene passato prima che sia stata inviata una notifica Push, l'adattatore informa la tua app, e la tua app dice al tuo server Push Notification che la notifica non è più necessaria.

Per quanto ne sappiamo, siamo l'unico fornitore di sale d'attesa virtuali che supporta questa funzione.

Risorse video

Ecco un video del Native App Adapter in azione, che mostra che il posto dell'utente viene salvato anche se l'app è completamente ferma, e mostra anche i ganci dell'adattatore che l'app usa per inviare notifiche Push.

Risorse aggiuntive

I nostri adattatori App nativi sono descritti nella Guida tecnica. La guida tecnica è disponibile nel portale Queue-Fair > sezione Aiuto, oppure puoi richiederne una copia a noi. Puoi anche trovare maggiori informazioni su ciascuno degli adattatori specifici per iOS e Android nel README.md di ogni repository GitHub.


Adattatori ECommerce

Queue-Fair può essere aggiunto facilmente a qualsiasi sistema di eCommerce usando l'adattatore JavaScript lato client descritto sopra.

Offriamo anche codice adattatore per lavorare sul lato server con molti server eCommerce popolari.

Repository GitHub

Magento Plugin

Magento

Il repository GitHub per l'adattatore Queue-Fair Virtual Waiting Room per Magento.

Adattatore per sala d'attesa virtuale WooCommerce/PHP

WooCommerce

Il repository GitHub per l'adattatore Queue-Fair Virtual Waiting Room per WooCommerce in PHP.

Adattatore per sala d'attesa virtuale PrestaShop/PHP

PrestaShop

Il repository GitHub per l'adattatore Queue-Fair Virtual Waiting Room per PrestaShop in PHP.

Risorse aggiuntive

I nostri adattatori sono descritti nella Guida tecnica. La guida tecnica è disponibile nel portale Queue-Fair > sezione Aiuto, oppure puoi richiederne una copia a noi.

Abbiamo anche guide supplementari disponibili per la maggior parte delle piattaforme di eCommerce - basta chiedere quella che si desidera.


Sicurezza ibrida

Puoi facilmente combinare la flessibilità dell'adattatore JavaScript lato client con il livello di sicurezza aggiuntivo fornito dal nostro codice lato server.

Queue-Fair firma ogni visitatore che passiamo con un'impronta digitale che è unica per quel visitatore. Unicamente nel settore, la firma include anche un codice specifico per il browser del visitatore, per evitare che i token di accesso siano condivisi.

Il tuo server web può convalidare la firma utilizzando un segreto noto solo a te e a noi - non ai tuoi visitatori - per garantire che ogni visitatore sia stato passato correttamente dai server Queue-Fair.

Quindi, è possibile utilizzare l'adattatore JavaScript lato client per inviare e ricevere visitatori da e verso la coda, e controllare le manomissioni prima che si ordinino con un codice minimo lato server, ed evitare di introdurre una dipendenza dal nostro sistema.

Il codice di esempio è incluso nei nostri repository GitHub in tutti i principali linguaggi di programmazione web.

Repository GitHub

PHP

PHP

Il repository GitHub per l'adattatore lato server della sala d'attesa virtuale Queue-Fair in PHP.

Java

Java

Il repository GitHub per il Queue-Fair Virtual Waiting Room Server-Side Adapter per Java, inclusi JBoss e Tomcat.

Ruby

Ruby

Il repository GitHub per l'adattatore lato server della sala d'attesa virtuale Queue-Fair in Ruby e (opzionalmente) Rails.

Python

Python

Il repository GitHub per l'adattatore lato server della sala d'attesa virtuale Queue-Fair in Python e (opzionalmente) Django.

.NET

.NET

Il repository GitHub per l'adattatore lato server della sala d'attesa virtuale Queue-Fair per .NET, ASP e C#.

Node.js & JavaScript Virtual Waiting Room Adapter') ?>

Node.js & JavaScript

Il repository GitHub per l'adattatore lato server della sala d'attesa virtuale Queue-Fair per Node.js e (opzionalmente) Express.

Risorse aggiuntive

Il modello di sicurezza ibrido è completamente descritto nella Guida tecnica. La guida tecnica è disponibile nel portale Queue-Fair > sezione Aiuto, oppure potete richiederne una copia a noi.


Licenza

Il nostro codice pubblicato, disponibile su GitHub Queue-Fair Repository, è rilasciato sotto la licenza MIT, che è tra le più permissive delle licenze Open Source.


Vuoi sapere come funziona Queue-Fair?