Hulpmiddelen voor ontwikkelaars

Google Tag Manager

De GitHub repository voor de Queue-Fair virtuele wachtkamer Google Tag Manager client-side adapter tag.

Dynamische wachtrij-pagina's

Alle gegevens die u wenst kunnen worden doorgegeven van uw site naar ons wachtrijsysteem en de wachtrijpagina's die uw bezoekers te zien krijgen door gebruik te maken van het attribuut data-queue-fair-extra dat beschikbaar is in de Client-Side JavaScript Tag en de Google Tag Manager-implementatie. Neem contact op met ondersteuning als u dynamische wachtrijpagina's wilt inschakelen op uw account.

U kunt deze functie gebruiken om wachtrijpagina's on the fly aan te passen. U kunt Queue-Fair ook gebruiken om gegevens die u met uw bezoekers meestuurt terug te sturen naar uw site als ze door de wachtrij worden doorgelaten, voor een extra beveiligingslaag.

Wij bieden ook een dynamische Queue Page API die gebruik maakt van de extra gegevens om elk aspect van een Queue Page aan te passen, zodat u één wachtrij kunt maken voor uw hele site en deze automatisch kunt aanpassen voor verschillende evenementen of producten op uw site, zonder dat u wijzigingen hoeft aan te brengen in uw Queue Pages in de Queue-Fair Portal.

Shopify, WooCommerce & Wordpress wachtrij beheer

Als u een Wordpress-gebaseerde site gebruikt, zoals het WooCommerce shopping cart systeem, kan u gemakkelijk de Client-Side JavasScript Adapter tag toevoegen door gebruik te maken van de Wordpress Insert Headers & Footers Plugin, zonder dat u uw Thema's of templates moet aanpassen of Wordpress code moet aanraken.

Download gewoon de Insert Headers & Footers Plugin, pak het uit in uw /wp-content/plugins/ map, activeer de plugin in het Plugins menu, open de plugin vanuit het Instellingen menu, voeg de tag toe aan Scripts in Header zoals afgebeeld, klik op Save onderaan de pagina, en u bent klaar! Wordpress wachtrij beheer eenvoudig gemaakt. Er zijn andere Wordpress plugins die je kan gebruiken om de tag toe te voegen - deze is de meest populaire.

Sommige Wordpress klanten willen de Queue-Fair JavaScript tag ook toevoegen aan hun Wordpress error pagina's, wat u kunt doen door /wp-includes/functions.php te bewerken - voeg het toe aan de HTML binnen de _default_wp_die_handler functie in dat bestand.

Shopify is net zo eenvoudig - hier zijn instructies voor het toevoegen van de Queue-Fair Client-Side JavaScript Adapter aan je Shopify winkel - gebruik de drie puntjes linksboven nadat je op Aanpassen hebt geklikt om Code te Bewerken in je theme.liquid Layout bestand.

SquareSpace virtuele wachtruimte voor de klant

De Client-Side JavaScript Adapter is ook heel eenvoudig toe te voegen aan je SquareSpace site - log in en selecteer je website, dan Website in het linker nav, Website Tools (in de Utilities sectie in het linker nav), Code Injection, en kopieer en plak het dan in het Header vak, dan Opslaan linksboven.

Gebruik voor maximale beveiliging op SquareSpace onze SquareSpace Network-Edge Adapter, die hieronder wordt beschreven.

Client-Side Adapter Aanvullende bronnen

De client-side adapter wordt volledig beschreven in de technische handleiding. De technische gids is beschikbaar in de Queue-Fair Portal > Help-sectie, of u kunt een exemplaar bij ons aanvragen.

Terwijl de Client-Side Adapter in JavaScript in de browsers van uw bezoekers draait, draaien de Queue-Fair Server-Side Adapters op uw webserver.Dit betekent dat uw servers bezoekers efficiënter naar de wachtrij kunnen sturen. Bad actors zullen geen inhoud van je site zien, maar bots kunnen nog steeds verzoeken doen aan je servers, dus voor volledige DDoS-bescherming gebruik je een van onze Network-Edge Adapters hieronder.

Webserver-adapters

Dit betekent dat uw webserver gebruik kan maken van extra beveiligingsfuncties om toegang te weigeren aan mensen die niet in de wachtrij zijn geplaatst. Dit betekent ook dat uw webserver de belasting van het genereren en serveren van pagina's met Adapter script vermijdt.

Het toevoegen van de Queue-Fair Server-Side Adapter bibliotheken neemt slechts een paar minuten in beslag met minimale code veranderingen om de Adapter te activeren en te draaien.

De meeste van onze klanten beginnen met de Client-Side JavaScript Adapter en stappen pas over op de Server-Side Adapter als er een specifieke functionaliteit of bedrijfsbehoefte is.

Eenvoudige en veilige modus

De Queue-Fair Server-Side Adapters kunnen werken in Eenvoudige of Veilige modus.

In Eenvoudige Modus worden alle bezoekers naar de Queue-Fair Servers gestuurd om geteld te worden, of er nu wel of niet een wachtrij is gevormd. Als er een wachtrij is, voegen ze zich bij de wachtrij. Als er geen wachtrij is, worden ze direct teruggestuurd naar uw Web Server, zonder een wachtrijpagina te zien - maar met de handtekening die uw Web Server nodig heeft om ervoor te zorgen dat alleen mensen die door de wachtrij zijn gehaald toegang hebben tot uw beschermde bronnen.

In de Veilige Modus worden bezoekers alleen naar de Queue-Fair Servers gestuurd als er een wachtrij is. Uw webserver raadpleegt rechtstreeks onze Queue Servers op de achtergrond om deze bepaling te maken. Bezoekers worden nog steeds veilig digitaal ondertekend, of ze nu in een wachtrij komen, of dat ze worden gepasseerd zonder een wachtrijpagina te zien omdat de wachtrij leeg is.

Veilige modus wordt aanbevolen voor dagelijkse wachtrijen. De eenvoudige modus is geschikt voor een getimed evenement of verkoop wanneer u duizenden mensen verwacht, omdat er geen vertraging optreedt door de controle-oproep van uw webserver naar onze wachtrijservers, wat betekent dat u mensen efficiënter in de wachtrij kunt laten aansluiten.

GitHub Repositories

PHP

De GitHub repository voor de Queue-Fair Virtual Waiting Room Server-Side Adapter in PHP.

Java

De GitHub repository voor de Queue-Fair Virtual Waiting Room Server-Side Adapter voor Java, inclusief JBoss en Tomcat.

Ruby

De GitHub repository voor de Queue-Fair Virtual Waiting Room Server-Side Adapter in Ruby en (optioneel) Rails

Python

De GitHub repository voor de Queue-Fair Virtual Waiting Room Server-Side Adapter in Python en (optioneel) Django.

.NET

De GitHub repository voor de Queue-Fair Virtual Waiting Room Server-Side Adapter voor .NET, ASP en C#.

Node.js

De GitHub repository voor de Queue-Fair Virtual Waiting Room Server-Side Adapter voor Node.js en (optioneel) Express.

Dynamische wachtrij-pagina's

Net als bij de Client-Side Adapter kunnen alle gegevens die je wilt van je webserver naar onze servers en de wachtrijpagina's die je bezoekers te zien krijgen, worden doorgegeven door deze informatie door te geven in de Server-Side Adapter call wanneer mensen in de wachtrij komen. Dit maakt dynamische wachtrijpagina's of andere on-the-fly-aanpassingen op dezelfde manier mogelijk - alle functies van de Client-Side Adapter worden volledig ondersteund. Neem contact op met support als u dynamische wachtrijpagina's wilt inschakelen voor uw account.

Server-Side Adapter Aanvullende bronnen

Onze Server-Side Adapters worden volledig beschreven in de Technische Gids. De Technische Handleiding is beschikbaar in de Queue-Fair Portal > Help sectie, of u kunt een kopie bij ons opvragen. U kunt ook meer informatie vinden over elk van de Adapters in de README.md van elke GitHub global community repository.

De Queue-Fair Network-Edge Adapters draaien binnen het framework van uw CDN of Cloud Services provider, in plaats van in de browsers van de bezoekers of op uw origin server. Dit is de beste manier om Queue-Fair te gebruiken om je servers te beschermen tegen botaanvallen, waaronder DDoS-aanvallen.

Lambda en CDN-aanbieder adapters

Dit geeft dezelfde functionaliteit en beveiliging als de Server-Side Adapter en dezelfde belastingbescherming als Direct Link.

Het toevoegen van de Queue-Fair Network-Edge Adapter libraries kost slechts een paar minuten met minimale codewijzigingen bij uw cloudprovider om de Adapter te activeren en uit te voeren, die normaal gesproken wordt ingezet als een Lambda-functie of Edge Worker.

Eenvoudige en veilige modus

Net als onze Server-Side Adapters, kunnen onze Network-Edge Adapters in Simple of Safe mode werken.

Beschikbare Adapters

Cloudfront

Amazon AWS CloudFront Network-Edge Virtual Waiting Room Adapter.

Cloudflare

Cloudflare Network-Edge Virtual Waiting Room Adapter

Fastly

Fastly Network-Edge Virtual Waiting Room Adapter.

Akamai

Akamai Network-Edge Virtual Waiting Room Adapter.

Azure

Azure netwerkniveau virtuele wachtkameradapter.

Google Cloud

Google Cloud Network-Level Virtual Waiting Room Adapter.

Dynamische wachtrij-pagina's

Net als bij de client-side-adapter kunnen alle gegevens die je wilt van je site naar onze servers en de wachtrijpagina's die je bezoekers te zien krijgen, worden doorgegeven door deze informatie door te geven in de adapteraanroep. Dit vergemakkelijkt dynamische wachtrijpagina's of andere on-the-fly aanpassingen, aangezien mensen op dezelfde manier in de wachtrij komen - alle functies van de client-side-adapter worden volledig ondersteund. Neem contact op met support als u dynamische wachtrijpagina's wilt activeren voor uw account.

Netwerk-Edge Adapter Aanvullende bronnen

Onze Network-Edge Adapters worden volledig beschreven in de Technische Gids. De Technische Handleiding is beschikbaar in de Queue-Fair Portal > Help-sectie, of u kunt een exemplaar bij ons opvragen. U kunt ook meer informatie vinden over elk van de Adapters in de README.md van elke GitHub global community repository.

Queue-Fair geeft ontwikkelaars toegang tot zes REST API Modules. U heeft een Queue-Fair account nodig om de API te gebruiken. Om API toegang voor uw account mogelijk te maken, kunt u contact opnemen met Queue-Fair Support. Onze REST API Modules voldoen aan de OpenAPI, RFC 7807 en RFC 3339 standaarden.

Onze suite van API modules is uitgebreid - alles wat u kunt doen in het portaal, kunt u ook doen met de API, met uitzondering van het beheren van portaalgebruikers, wat is uitgesloten om privacy redenen.

Elke API-module is volledig gedocumenteerd op api.queue-fair.net, waar u ook een Swagger-interface vindt voor gebruiksgemak en testen. Voor de veiligheid zijn alle API-oproepen beveiligd door veilige TLS-encryptie en vereisen ze een API-sleutel die specifiek is voor uw account.

API modules

Dynamische wachtrij-pagina's

U kunt uw wachtrijpagina's ook direct wijzigen zonder de database te hoeven bijwerken met behulp van de portaal- of presentatie-API - Neem contact op met Support voor meer informatie en om dynamische wachtrijpagina's op uw account in te schakelen.

REST API Aanvullende bronnen

Zoals vereist door RFC 7807, kunt u documentatie vinden over foutmeldingen die kunnen worden geretourneerd door onze REST API Modules op queue-fair.com/api-error

Queue-Fair ziet er goed uit op mobiele browsers, maar ook op desktops en laptops.

U kunt Queue-Fair ook rechtstreeks gebruiken in uw native iOS- en Android-apps, en ook React Native-apps op iOS, Android, Windows en MacOS, om resource-intensieve activiteiten of bewerkingen te beschermen.

De Queue-Fair App Adapters gebruiken een WebClient om apps te verbinden en aangepaste wachtrijweergaven te tonen aan uw gebruikers wanneer uw diensten te druk zijn, met de flexibiliteit en het gebruiksgemak van de Queue-Fair Portal.

U kunt gebruikers in dezelfde wachtrij plaatsen als uw websitebezoekers, of een aparte wachtrij opzetten voor uw app-gebruikers - de keuze is aan u.

Net als bij onze webgebaseerde wachtrijen wordt de plaats van elke gebruiker automatisch opgeslagen als hij eenmaal in de wachtrij is opgenomen, ook als hij uit uw app wegnavigeert.

GitHub Repositories

iOS & MacOS

De GitHub repository voor de Queue-Fair Virtual Waiting Room iOS en MacOS Adapter.

Android

De GitHub repository voor de Queue-Fair virtuele wachtkamer-adapter voor Android.

React Native

De GitHub repository voor de Queue-Fair Virtual Waiting Room Adapter voor React Native apps voor Android, iOS, MacOS en Windows.

Wachtrij meldingen

De Queue-Fair Adapter heeft callbacks die het eenvoudig maken om Push Notification te sturen naar gebruikers die uw app of wachtrij niet gebruiken wanneer hun beurt wordt afgeroepen. De plaats van de gebruiker in de wachtrij wordt door de Adapter automatisch persistent opgeslagen in je App. Als de gebruiker wegnavigeert van uw app, vertelt uw app uw Push Notification-server dat een melding moet worden verzonden, waarbij de opgeslagen informatie over de wachtrijpositie als onderdeel van dat bericht naar uw Push Notification-server wordt verzonden.

Het is dezelfde technologie die we gebruiken voor onze WeQ4U consumentenapp en -service, die alleen al in het Verenigd Koninkrijk zo'n 2 miljoen keer is gedownload.

Uw Push Notification server raadpleegt de Queue-Fair Status API periodiek om de wachtrijpositie op te vragen die op dat moment wordt bediend. Wanneer deze groter is dan de wachtrijpositie van een bepaalde gebruiker, is het tijd om contact op te nemen met die gebruiker met de melding. Als de gebruiker terugkeert naar de wachtrij of wordt gepasseerd voordat een Push Notification is verzonden, brengen de callbacks in de Adapter uw app op de hoogte, en uw app vertelt uw Push Notification-server dat de melding niet langer nodig is.

Voor zover wij weten, zijn wij de enige Virtual Waiting Room provider die deze functie ondersteunt.

Video-bronnen

Hier is een video van de Native App Adapter in actie, die laat zien dat de plaats van de gebruiker wordt opgeslagen, zelfs als de app volledig is gestopt, en ook de Adapter-haken toont die je app gebruikt om Push Notifications te versturen.

Extra middelen

Onze Native App Adapters worden beschreven in de Technische Gids. De Technische Handleiding is beschikbaar in de Queue-Fair Portal > Help-sectie, of u kunt een exemplaar bij ons opvragen. U kunt ook meer informatie vinden over elk van de Adapters die specifiek is voor iOS en Android in de README.md van elke GitHub global community repository.

Queue-Fair kan eenvoudig worden toegevoegd aan elk e-commerce systeem met behulp van de Client-Side JavaScript Adapter die hierboven is beschreven.

Wij bieden ook Adapter code aan om aan de Server-Side te werken met vele populaire eCommerce servers.

GitHub Repositories

Magento

De GitHub repository voor de Queue-Fair virtuele wachtkamer adapter voor Magento.

WooCommerce

De GitHub repository voor de Queue-Fair virtuele wachtkamer adapter voor WooCommerce in PHP.

SquareSpace

De GitHub repository voor de Queue-Fair Virtual Waiting Room Adapter voor SquareSpace.

PrestaShop

De GitHub repository voor de Queue-Fair virtuele wachtkamer adapter voor PrestaShop in PHP.

Extra middelen

Onze adapters worden beschreven in de technische gids. De technische gids is beschikbaar in de Queue-Fair Portal > Help-sectie, of u kunt een exemplaar bij ons aanvragen.

We hebben ook aanvullende gidsen beschikbaar voor de meeste e-commerce platforms - vraag gewoon naar de gids die u wilt.

U kunt de flexibiliteit van de Client-Side JavaScript Adapter gemakkelijk combineren met de extra beveiligingslaag van onze Server-Side code.

Queue-Fair ondertekent elke bezoeker die we passeren met een digitale vingerafdruk die uniek is voor die Bezoeker. Uniek in de sector is dat de handtekening ook een code bevat die specifiek is voor de browser van de bezoeker, om te voorkomen dat toegangstokens worden gedeeld.

Uw webserver kan de handtekening valideren met behulp van een geheim dat alleen bij u en ons bekend is - niet bij uw bezoekers - om er zeker van te zijn dat elke bezoeker eerlijk door de Queue-Fair-servers is gepasseerd.

Je kunt dus de Client-Side JavaScript Adapter gebruiken om bezoekers van en naar de wachtrij te sturen en te ontvangen, en controleren op geknoei voordat ze bestellen met minimale Server-Side code, en vermijden dat je afhankelijk wordt van ons systeem.

Voorbeeldcode is opgenomen in onze GitHub wereldwijde community repositories in elke belangrijke web programmeertaal.

GitHub Repositories

PHP

De GitHub repository voor de Queue-Fair Virtual Waiting Room Server-Side Adapter in PHP.

Java

De GitHub repository voor de Queue-Fair Virtual Waiting Room Server-Side Adapter voor Java, inclusief JBoss en Tomcat.

Ruby

De GitHub repository voor de Queue-Fair Virtual Waiting Room Server-Side Adapter in Ruby en (optioneel) Rails

Python

De GitHub repository voor de Queue-Fair Virtual Waiting Room Server-Side Adapter in Python en (optioneel) Django.

.NET

De GitHub repository voor de Queue-Fair Virtual Waiting Room Server-Side Adapter voor .NET, ASP en C#.

Node.js

De GitHub repository voor de Queue-Fair Virtual Waiting Room Server-Side Adapter voor Node.js en (optioneel) Express.

Extra middelen

Het Hybride Beveiligingsmodel wordt volledig beschreven in de Technische Gids. De Technische Gids is beschikbaar in de Queue-Fair Portal > Help-sectie, of u kunt een exemplaar bij ons aanvragen.

Onze gepubliceerde code die beschikbaar is op de GitHub Queue-Fair Repository is gelicenseerd onder de MIT Licentie, die tot de meest permissieve van Open Source licenties voor de wereldwijde gemeenschap behoort.