Hulpmiddelen voor ontwikkelaars



Queue-Fair toevoegen

De Queue-Fair virtuele wachtkamer kan in enkele minuten worden toegevoegd aan een groot aantal web- en app-platforms. U hoeft alleen maar een van onze Adapters te gebruiken. Meer informatie over de beste manier om Queue-Fair te integreren met uw bestaande systeem vindt u in de Technische Gids, of in de Queue-Fair Portal > Help-sectie.

De client-zijde adapter

Voor websites is de eenvoudigste manier om te integreren met Queue-Fair het toevoegen van de Client-Side Queue-Fair Adapter JavaScript tag aan uw pagina's. U kunt de adapter veilig toevoegen aan alle pagina's op uw site, en de activeringsregels in het Queue-Fair Portal gebruiken om te bepalen welke pagina's een wachtrij mogen werpen.

Omdat de Client-Side Adapter in de browser van uw bezoekers wordt uitgevoerd, kan hij door technisch onderlegde bezoekers worden uitgeschakeld, maar hij is zeer effectief bij het voorkomen van overbelasting, aangezien slechts een zeer kleine minderheid van de mensen zal proberen de wachtrij over te slaan door met het JavaScript te knoeien. De meeste van onze klanten gebruiken de Client-Side Adapter omdat het effectief is om een gecrashte site te voorkomen, eenvoudig te installeren is en geen afhankelijkheid introduceert tussen ons systeem en dat van u.

Je kunt een beveiligingslaag toevoegen door de JavaScript-tag te vervangen door een Server-Side Adapter, of de flexibiliteit van de JavaScript Adapter combineren met het Hybrid Security Model dat op deze pagina wordt beschreven; beide methoden zijn dan veilig.

Enkele regel code

Om de Client-Side Adapter aan uw site toe te voegen, voegt u de volgende enkele regel code toe aan de <head> sectie van uw pagina's:

Voeg onze virtuele wachtkamer toe aan uw site met deze enkele regel code en voorkom website crashes

Sommige klanten voegen het woord defer aan de tag, waardoor het Adapter-script parallel met het parseren van de pagina wordt gedownload en ook pas met de uitvoering van het script in de browser van de bezoeker wordt begonnen als het parseren van de pagina is voltooid (dus meestal nadat alle andere scripts op uw pagina zijn voltooid).

Het toevoegen van het woord defer kan in sommige gevallen de Time to First Paint met een kleine fractie van een seconde verbeteren, maar als u hiervoor kiest, betekent dit dat bezoekers die in een wachtrij zouden moeten worden geplaatst, uw beveiligde pagina een fractie van een seconde langer te zien krijgen voordat ze naar de wachtrij worden gestuurd.

Google Tag Manager

Wij bieden ook de JavaScript Adapter Tag aan via Google Tag Manager. Zoek naar Queue-Fair in de Community Templates Galerie, onder Tag toevoegen. Houd er rekening mee dat sommige ad blockers het downloaden van de master gtm.js van Google verhinderen, waardoor alle bewerkingen van Google Tag Manager worden geblokkeerd, inclusief het uitvoeren van de Adapter voor die bezoekers.Onze virtuele wachtkamer tag voor Google Tag Manager

GitHub Repositories

Google Tag Manager

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 onze servers 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.



Wordpress & WooCommerce

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 uw Thema's aan te passen of enige Wordpress code aan te raken.

Download gewoon de Insert Headers & Footers Plugin, pak het uit in je /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, druk op Save onderaan de pagina, en je bent klaar!

Het Queue-Fair Portaal Dashboard

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.


Server-Side Adapters

Terwijl de Client-Side Adapter in JavaScript in de browsers van uw bezoekers draait, draaien de Queue-Fair Server-Side Adapters op uw webserver.

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 alleen over op de Server-Side Adapter als er een specifieke 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 geen wachtrij is gevormd. 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 onze Queue Servers rechtstreeks om dit te bepalen. Bezoekers worden nog steeds veilig digitaal ondertekend, of er nu wel of niet een wachtrijpagina wordt getoond.

De veilige modus wordt aanbevolen voor alledaagse wachtrijen. De eenvoudige modus is geschikt voor een getimed evenement waarbij u duizenden mensen verwacht, omdat er dan geen vertraging optreedt door de controle-oproep van uw webserver naar onze wachtrijservers, waardoor u mensen efficiënter naar de wachtrij kunt sturen.

GitHub Repositories

PHP virtuele wachtkamer adapter') ?>

PHP

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

Java virtuele wachtkamer adapter

Java

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

Ruby Virtuele Wachtkamer Adapter

Ruby

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

Python virtuele wachtkamer adapter

Python

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

dotNet virtuele wachtkamer adapter

.NET

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

Node.js & JavaScript virtuele wachtkamer adapter

Node.js & JavaScript

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-adapteraanroep. Dit vergemakkelijkt dynamische wachtrijpagina's of andere on-the-fly-aanpassingen op dezelfde manier - alle functies van de Client-Side Adapter worden volledig ondersteund. Neem contact op met support als u Dynamic Queue Pages 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 repository.


REST-API's

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

Rapportage API

Voor live, real-time rapporten, historische rapporten en geaggregeerde wachtrijstatistieken.

API voor wachtrijbeheer

Voor het maken en wijzigen van wachtrijen op programmatische wijze in real time.

API voor accountbeheer

Voor het bekijken en bijwerken van uw account-brede instellingen.

API voor vermogensbeheer

Voor het beheer van de activa die worden gebruikt door uw wachtrijpagina's die worden geserveerd door Google CDN.

Presentatie API

Voor het wijzigen van elk aspect van de HTML van uw wachtrijpagina's en het bijwerken en aanmaken van varianten on the fly.

Activering API

Voor het configureren van de activeringsregels die bepalen welke pagina's op uw site een wachtrij kunnen triggeren, en welke pagina wordt getoond.



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


Native Apps

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

Je kunt Queue-Fair ook rechtstreeks gebruiken in je 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 aangepaste wachtrijweergaven aan uw gebruikers te tonen 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 of zij ook buiten uw app navigeert.

GitHub Repositories

iOS, MacOS en Apple virtuele wachtkameradapter

iOS & MacOS

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

Android virtuele wachtkamer adapter

Android

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

React Native App Virtuele Wachtkamer Adapter

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 maakt het eenvoudig 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 uw 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-app voor consumenten, die alleen al in het Verenigd Koninkrijk zo'n 2 miljoen keer is gedownload.

Uw Push Notificatie 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 die gebruiker de notificatie te sturen. Als de gebruiker terugkeert naar de wachtrij of wordt gepasseerd voordat een Push Notification is verzonden, stelt de Adapter uw app daarvan 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 kopie 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 repository.


ECommerce Adapters

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 Plugin

Magento

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

WooCommerce/PHP virtuele wachtkamer adapter

WooCommerce

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

PrestaShop/PHP virtuele wachtkamer adapter

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.


Hybride Beveiliging

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.

In onze GitHub Repositories is voorbeeldcode opgenomen in elke belangrijke webprogrammeertaal.

GitHub Repositories

PHP

PHP

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

Java

Java

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

Ruby

Ruby

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

Python

Python

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

.NET

.NET

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

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

Node.js & JavaScript

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.


Licentie

Onze gepubliceerde code, beschikbaar op de GitHub Queue-Fair Repository, is gelicenseerd onder de MIT Licentie, een van de meest permissieve Open Source licenties.


Wil je weten hoe Queue-Fair werkt?