Risorse per sviluppatori



Aggiunta di Queue-Fair

La sala d'attesa virtuale Queue-Fair può essere facilmente aggiunta a un'ampia gamma di piattaforme web e app in pochi minuti. Basta utilizzare uno dei nostri adattatori. Per ulteriori informazioni sul modo migliore per integrare il servizio Queue-Fair con il sistema esistente, consultare la Guida tecnica o la sezione Portale Queue-Fair > Aiuto. Se state cercando informazioni su come impedire ai bot o agli esseri umani di effettuare ordini multipli, o proteggere le vostre vendite NFT da commissioni eccessive per il gas, potete leggere questa panoramica o ottenere tutti i dettagli nella sezione Guida alla sicurezza del portale.

Il modo più rapido per iniziare a lavorare con Queue-Fair è quello di registrarsi per un account. Livello gratuito e iniziare subito l'integrazione e i test.

Avete bisogno di aiuto per impostare le tariffe della vostra coda? Tutto quello che c'è da sapere è qui.

L'adattatore lato client

Per i siti web, il modo più semplice per integrarsi con Queue-Fair è aggiungere il tag JavaScript dell'adattatore Queue-Fair lato client alle vostre pagine. Potete tranquillamente aggiungere l'adattatore a tutte le pagine del vostro sito e utilizzare le Regole di attivazione nel portale Queue-Fair per determinare quali pagine possono lanciare una coda.

Il nostro JavaScript Client-Side Adapter è più sicuro delle integrazioni lato client di altri fornitori. Poiché viene eseguito nel browser dei visitatori, l'adattatore lato client può essere manomesso da visitatori tecnicamente esperti, ma è molto efficace nel prevenire il sovraccarico, poiché solo una piccola minoranza di persone tenterà di saltare la coda manomettendo il codice JavaScript. La maggior parte dei nostri clienti utilizza l'adattatore lato client perché è efficace nel prevenire il crash del sito, è semplice da installare e non introduce alcuna dipendenza tra il nostro sistema e il vostro. A differenza delle integrazioni lato client di altri fornitori, può essere reso a prova di manomissione con il Modello di sicurezza ibrido descritto nella Guida tecnica.

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:

la comunità globale esclude l'ordinamento fiscale raffinare il prezzo del sistema di accodamento per i plugin wordpress

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. Cercare Queue-Fair nella Galleria dei modelli della Comunità, alla voce Aggiungi tag. Si noti 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 del sistema di code Adapter per questi visitatori.

plugin wordpress wp cron ottimo strumento per la ricerca wordpress e per i post della community del sito ad un ottimo prezzo

Repository GitHub

proprietà del plugin wordpress tasks per creare dati dollari senza bisogno di php

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 desiderate possono essere trasmessi dal vostro sito al nostro sistema di accodamento e alle pagine di coda visualizzate dai vostri visitatori utilizzando l'attributo data-queue-fair-extra, disponibile nel tag JavaScript lato client e nell'implementazione di Google Tag Manager. Contattare l'assistenza se si desidera abilitare le Pagine di coda dinamiche sul proprio account.

È possibile utilizzare questa funzione per personalizzare al volo le pagine di coda. Potete anche usare Queue-Fair per passare i dati che ci inviate con i vostri visitatori al vostro sito mentre passano dalla coda, per un ulteriore livello di sicurezza.

Forniamo anche un'API per le pagine di coda dinamiche che utilizza i dati aggiuntivi per personalizzare qualsiasi aspetto di una pagina di coda, in modo che possiate creare una coda per l'intero sito e personalizzarla automaticamente per i diversi eventi o prodotti del vostro sito, senza dover apportare alcuna modifica alle vostre pagine di coda nel portale Queue-Fair.



Gestione delle code di Shopify, WooCommerce e Wordpress

Se si utilizza un sito basato su Wordpress, come il sistema di carrello della spesa WooCommerce, è possibile aggiungere facilmente il tag Client-Side JavasScript Adapter utilizzando il plugin Wordpress Insert Headers & Footers, senza dover modificare alcun tema o modello o toccare alcun codice di Wordpress.

Basta scaricare il plugin Insert Headers & Footers, decomprimerlo nella 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 il gioco è fatto! La gestione delle code di Wordpress è diventata semplice. Esistono anche altri plugin per Wordpress che possono essere utilizzati per aggiungere il tag: questo è il più popolare.

Alcuni clienti di Wordpress amano aggiungere il tag JavaScript Queue-Fair anche alle loro pagine di errore di Wordpress, cosa che si può fare modificando /wp-includes/functions.php - aggiungendolo all'HTML contenuto nella funzione _default_wp_die_handler in quel file.

Shopify è altrettanto facile: ecco le istruzioni per aggiungere il Queue-Fair Client-Side JavaScript Adapter al vostro negozio Shopify - utilizzate i tre punti in alto a sinistra dopo aver premuto Customise per modificare il codice sul file theme.liquid Layout.

marche unire i modelli per il controllo del callback di sfondo sul punto

Sala d'attesa virtuale SquareSpace lato cliente

L'adattatore JavaScript lato client è anche molto facile da aggiungere al vostro sito SquareSpace: accedete e selezionate il vostro sito web, quindi Sito web dalla navata sinistra, Strumenti del sito web (nella sezione Utilità della navata sinistra), Iniezione di codice, quindi copiate e incollate il codice nella casella Intestazione, quindi Salva in alto a sinistra.

Per ottenere la massima sicurezza su SquareSpace, utilizzate il nostro SquareSpace Network-Edge Adapter, descritto di seguito.


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 nel browser dei visitatori, gli adattatori lato server Queue-Fair vengono eseguiti sul server web.Ciò significa che i vostri server possono inviare i visitatori alla coda in modo più efficiente. I malintenzionati non vedranno i contenuti del vostro sito, ma i bot potranno comunque fare richieste ai vostri server; per una protezione DDoS completa, utilizzate uno dei nostri Network-Edge Adapters qui sotto.

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 inizia con l'adattatore JavaScript lato client e passa all'adattatore lato server solo in presenza di una funzionalità specifica o di un'esigenza aziendale.

Modalità semplice e sicura

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

In modalità semplice, tutti i visitatori vengono inviati ai server Queue-Fair per essere contati, indipendentemente dal fatto che si sia formata o meno una coda. Quando c'è una coda, si uniscono alla coda. Se non c'è una coda, i visitatori vengono rimandati subito al server Web, senza vedere la pagina della coda, ma con la firma di cui il server Web ha bisogno per garantire che solo le persone che sono state superate dalla coda possano accedere alle risorse protette.

In modalità sicura, i visitatori vengono inviati ai server Queue-Fair solo quando c'è una coda. Il vostro server web consulta direttamente i nostri server di coda in background per effettuare questa determinazione. I visitatori vengono comunque firmati digitalmente in modo sicuro, sia che si uniscano a una coda, sia che passino senza vedere una pagina di coda perché la coda è vuota.

La modalità sicura è consigliata per le code quotidiane. La modalità semplice è adatta a un evento o a una vendita a tempo, quando si attendono migliaia di persone, in quanto elimina la latenza dovuta alla chiamata di controllo dal vostro server web ai nostri server di coda, il che significa che potete inviare le persone a unirsi alla coda in modo più efficiente.

Repository GitHub



Pagine di coda dinamiche

Come per il Client-Side Adapter, tutti i dati che desiderate possono essere passati dal vostro server web ai nostri server e alle pagine di coda che i vostri visitatori vedono, passando queste informazioni nella chiamata al Server-Side Adapter quando le persone si uniscono alla coda. Questo facilita la personalizzazione dinamica della pagina della coda o di altre funzioni al volo; tutte le funzioni di Client-Side Adapter sono pienamente supportate. Contattate l'assistenza se desiderate abilitare le Pagine di coda dinamiche sul vostro account.

Adattatore lato server Risorse aggiuntive

I nostri adattatori lato server sono descritti in dettaglio nella Guida tecnica. La Guida tecnica è disponibile nel portale Queue-Fair > sezione Aiuto, oppure è possibile richiederne una copia a noi. È inoltre possibile trovare ulteriori informazioni su ciascuno degli adattatori nel file README.md di ciascun repository della comunità globale GitHub.


Adattatori network edge

Gli adattatori Network-Edge Queue-Fair vengono eseguiti all'interno del framework del vostro CDN o del vostro fornitore di servizi cloud, anziché nei browser dei visitatori o sul vostro server di origine. Questo è il modo migliore per utilizzare Queue-Fair per proteggere i server dagli attacchi bot, compresi gli attacchi DDoS.

Adattatori per provider Lambda e CDN

Questo offre la stessa funzionalità e sicurezza dell'adattatore lato server e la stessa protezione del carico di Direct Link.

L'aggiunta delle librerie di Queue-Fair Network-Edge Adapter richiede solo pochi minuti con modifiche minime al codice del cloud provider per attivare ed eseguire l'adattatore, che normalmente viene distribuito come funzione Lambda o Edge Worker.

Modalità semplice e sicura

Come i nostri adattatori lato server, i nostri adattatori network edge possono funzionare in modalità semplice o sicura.

Adattatori disponibili



Pagine di coda dinamiche

Come per l'adattatore lato client, tutti i dati che desiderate possono essere trasmessi dal vostro sito ai nostri server e alle pagine di coda che i vostri visitatori visualizzano, passando queste informazioni nella chiamata all'adattatore. Questo facilita le pagine di coda dinamiche o altre personalizzazioni al volo, poiché le persone si uniscono alla coda nello stesso modo - tutte le funzioni dell'adattatore lato client sono pienamente supportate. Contattate l'assistenza se desiderate attivare le Pagine di coda dinamiche sul vostro account.

Scheda Network-Edge Risorse aggiuntive

I nostri adattatori Network-Edge sono descritti in dettaglio nella Guida tecnica. La Guida tecnica è disponibile nel portale Queue-Fair > sezione Aiuto, oppure è possibile richiederne una copia a noi. È inoltre possibile trovare ulteriori informazioni su ciascuno degli adattatori nel file README.md di ciascun repository della comunità globale 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 all'indirizzo 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



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.

È inoltre possibile utilizzare Queue-Fair direttamente nelle app native per iOS e Android, nonché nelle app React Native su iOS, Android, Windows e MacOS, per proteggere le attività o le operazioni che richiedono molte risorse.

Gli adattatori per app Queue-Fair utilizzano un WebClient per connettere le app e mostrare agli utenti visualizzazioni di code personalizzate quando i servizi sono troppo occupati, con la flessibilità e la facilità d'uso di 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, una volta entrato nella coda il posto di ogni utente viene salvato automaticamente anche se si allontana dalla vostra app.

Repository GitHub

Notifiche di coda

L'adattatore Queue-Fair dispone di callback che semplificano l'invio di notifiche push agli utenti che non stanno utilizzando l'applicazione o la coda quando viene chiamato il loro turno. Il posto dell'utente nella coda viene automaticamente memorizzato in modo persistente dall'adattatore nella vostra app. Se l'utente si allontana dall'applicazione, l'applicazione comunica al server Push Notification che deve essere inviata una notifica, inviando le informazioni sulla posizione nella coda memorizzate come parte del messaggio al server Push Notification.

È la stessa tecnologia che utilizziamo per la nostra applicazione e il nostro servizio WeQ4U per i consumatori, che ha avuto circa 2 milioni di download solo nel Regno Unito.

Il server di notifica push consulta periodicamente l'API Queue-Fair Status per interrogare la posizione della coda attualmente servita. Quando questa è maggiore della posizione in coda di un particolare utente, è il momento di contattare quell'utente con la notifica. Se l'utente torna alla coda o viene superato prima che sia stata inviata una notifica push, i callback dell'adattatore informano l'applicazione e quest'ultima comunica al server di notifica push 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 per app native sono descritti nella Guida tecnica. La Guida tecnica è disponibile nel portale Queue-Fair > sezione Aiuto, oppure potete richiederne una copia a noi. È inoltre possibile trovare ulteriori informazioni su ciascuno degli adattatori specifici per iOS e Android nel file README.md di ciascun repository della comunità globale 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

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.

Nei repository della nostra comunità globale GitHub sono inclusi esempi di codice in tutti i principali linguaggi di programmazione web.

Repository GitHub

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 sul Repository GitHub Queue-Fair, è rilasciato sotto la licenza MIT, che è tra le licenze Open Source più permissive per la comunità globale.


Vuoi sapere come funziona Queue-Fair?