Ressourcer til udviklere



Tilføjelse af Queue-Fair

Queue-Fair Virtual Waiting Room kan nemt tilføjes til en lang række forskellige web- og app-platforme på få minutter. Du skal blot bruge en af vores adaptere. Du kan finde flere oplysninger om den bedste måde at integrere Queue-Fair med dit eksisterende system på i den tekniske vejledning eller i Queue-Fair Portal > Hjælp-sektionen. Hvis du leder efter oplysninger om, hvordan du kan forhindre bots eller mennesker i at lave flere ordrer eller beskytte dit NFT-salg mod for høje gasgebyrer, kan du læse denne oversigt eller få alle detaljer i afsnittet Sikkerhedsguide på portalen.

Adapter på klient-siden

For websteder er den enkleste måde at integrere med Queue-Fair på at tilføje JavaScript-tagget Client-Side Queue-Fair Adapter til dine sider. Du kan uden problemer tilføje adapteren til alle siderne på dit websted og bruge aktiveringsreglerne i Queue-Fair-portalen til at bestemme, hvilke sider der kan kaste en kø.

Da den kører i dine besøgendes browsere, kan Client-Side Adapter deaktiveres af teknisk dygtige besøgende, men den er meget effektiv til at forhindre overbelastning, da kun et meget lille mindretal af personer vil forsøge at springe køen over ved at manipulere med JavaScript. De fleste af vores kunder bruger Client-Side Adapter, fordi den er effektiv til at forhindre et nedstyrtet websted, er enkel at installere og ikke indfører nogen afhængighed mellem vores og dit system.

Du kan tilføje et sikkerhedslag ved at erstatte JavaScript-tagget med en server-sideadapter eller kombinere JavaScript-adapterens fleksibilitet med den hybride sikkerhedsmodel, der er beskrevet på denne side; begge metoder er sikre.

En enkelt linje kode

For at tilføje Client-Side Adapter til dit websted skal du blot tilføje følgende enkelt linje kode til <head> afsnittet på dine sider:

Tilføj vores virtuelle venteværelse til dit websted med denne enkelt linje kode og undgå nedbrud på dit websted

Nogle kunder tilføjer ordet defer til tagget, hvilket får Adapter-scriptet til at blive downloadet parallelt med analyseringen af siden og også til først at starte udførelsen af scriptet i den besøgendes browser, når siden er færdig med at analysere (altså typisk efter at andre scripts på din side er færdige).

Tilføjelse af ordet defer kan i nogle tilfælde forbedre Time to First Paint med en lille brøkdel af et sekund, men hvis du vælger at gøre dette, betyder det, at besøgende, der burde stå i kø, vil se din beskyttede side i en brøkdel af et sekund længere, før de sendes til køen.

Google Tag Manager

Vi tilbyder også JavaScript Adapter Tag via Google Tag Manager. Søg efter Queue-Fair i galleriet Community Templates Gallery under Tilføj tag. Bemærk venligst, at nogle reklameblokker forhindrer download af master gtm.js fra Google, hvilket blokerer alle operationer af Google Tag Manager, herunder at køre Adapteren for disse besøgende.Vores tag for virtuelle venteværelser til Google Tag Manager

GitHub-repositorier

Google Tag Manager

Google Tag Manager

GitHub-repositoriet for QFXNNPQ Virtual Waiting Room Google Tag Manager Client-Side Adapter Tag.

Dynamiske kø-sider

Alle data, du ønsker, kan sendes fra dit websted til vores servere og de kø-sider, som dine besøgende ser, ved hjælp af data-queue-fair-extra-attributten, der er tilgængelig i Client-Side JavaScript Tag og Google Tag Manager-implementeringen. Kontakt venligst support, hvis du ønsker at aktivere dynamiske kø-sider på din konto.

Du kan bruge denne funktion til at tilpasse kø-sider i farten. Du kan også bruge Queue-Fair til at sende data, som du sender til os med dine besøgende, tilbage til dit websted, når de passerer køen, for at opnå et ekstra sikkerhedslag.

Vi leverer også en dynamisk kø-side API, der bruger de ekstra data til at tilpasse ethvert aspekt af en kø-side, så du kan oprette én kø til hele dit websted og tilpasse den automatisk til forskellige begivenheder eller produkter på dit websted, uden at du behøver at foretage ændringer i dine kø-sider i Queue-Fair-portalen.



Shopify, Wordpress og WooCommerce

Hvis du bruger et Wordpress-baseret websted, som f.eks. WooCommerce-shoppingvognsystemet, kan du nemt tilføje Client-Side JavasScript Adapter-tag'et ved hjælp af Wordpress Insert Headers & Footers Plugin uden at skulle ændre dine temaer eller røre ved Wordpress-kode.

Du skal blot downloade Insert Headers & Footers Plugin, udpakke det til din /wp-content/plugins/ mappe, Aktiver plugin'et i Plugins menuen, åbn plugin'et fra Settings menuen, tilføj tagget til Scripts i Header som vist, tryk på Save nederst på siden, og du er færdig!

Shopify er lige så nemt - her er en vejledning i at tilføje Queue-Fair Client-Side JavaScript Adapter til din Shopify-butik.

Queue-Fair Portal Dashboard

Client-side adapter Yderligere ressourcer

Adapteren på klientsiden beskrives i sin helhed i den tekniske vejledning. Den tekniske vejledning er tilgængelig i Queue-Fair Portal > Hjælp-sektionen, eller du kan anmode om et eksemplar fra os.


Adaptere på serversiden

Mens Client-Side Adapter kører i JavaScript i dine besøgendes browsere, kører Queue-Fair Server-Side Adapterne på din webserver.

Webserver-adaptere

Det betyder, at din webserver kan udnytte yderligere sikkerhedsfunktioner til at nægte adgang for personer, der ikke er blevet sat i kø. Det betyder også, at din webserver undgår den belastning, som generering og servering af sider med Adapter-script medfører.

Tilføjelse af Queue-Fair Server-Side Adapter-bibliotekerne tager kun et par minutter med minimale kodeændringer for at aktivere og køre Adapteren.

De fleste af vores kunder starter med Client-Side JavaScript Adapter og går kun over til Server-Side Adapter, hvis der er et specifikt forretningsmæssigt behov.

Enkel og sikker tilstand

Queue-Fair-adaptere på serversiden kan fungere i simpel eller sikker tilstand.

I simpel tilstand sendes alle besøgende til Queue-Fair-serverne for at blive talt, uanset om der er dannet en kø eller ej. Når der ikke er nogen kø, sendes de tilbage til din webserver med det samme uden at se en kø-side - men med den signatur, som din webserver har brug for, for at sikre, at kun personer, der er blevet passeret af køen, kan få adgang til dine beskyttede ressourcer.

I sikker tilstand sendes besøgende kun til Queue-Fair-serverne, når der er en kø. Din webserver henvender sig direkte til vores kø-servere for at foretage denne bestemmelse. Besøgende er stadig sikkert digitalt signeret, uanset om der vises en kø-side eller ej.

Sikker tilstand anbefales til daglige køer. Simpel tilstand er velegnet til en tidsbestemt begivenhed, hvor du forventer tusindvis af mennesker, da den eliminerer latenstid på grund af kontrolopkaldet fra din webserver til vores kø-servere, hvilket betyder, at du kan sende folk til køen mere effektivt.

GitHub-repositorier

PHP-adapter til virtuelt venteværelse') ?>

PHP

GitHub-repositoriet for Queue-Fair Virtual Waiting Room Server-Side Adapter i PHP.

Java-adapter til virtuelt venteværelse

Java

GitHub-repositoriet for Queue-Fair Virtual Waiting Room Server-Side Adapter for Java, herunder JBoss og Tomcat.

Ruby Adapter til virtuelt venteværelse

Ruby

GitHub-repositoriet for Queue-Fair Virtual Waiting Room Server-Side Adapter i Ruby og (valgfrit) Rails.

Python-adapter til virtuelt venteværelse

Python

GitHub-repositoriet for Queue-Fair Virtual Waiting Room Server-Side Adapter i Python og (valgfrit) Django.

dotNet-adapter til virtuelt venteværelse

.NET

GitHub-repositoriet for Queue-Fair Virtual Waiting Room Server-Side Adapter for .NET, ASP og C#.

Node.js og JavaScript Adapter til virtuelt venteværelse

Node.js & JavaScript

GitHub-repositoriet for Queue-Fair Virtual Waiting Room Server-Side Adapter for Node.js og (eventuelt) Express.



Dynamiske kø-sider

Som med Client-Side Adapter kan alle data, du ønsker, sendes fra din webserver til vores servere og de kø-sider, som dine besøgende ser, ved at sende disse oplysninger i Server-Side Adapter-kaldet. Dette gør det muligt at foretage dynamisk kø-side- eller anden tilpasning i farten på samme måde - alle funktioner i Client-Side Adapter er fuldt understøttet. Kontakt venligst support, hvis du ønsker at aktivere Dynamic Queue Pages på din konto.

Server-side adapter Yderligere ressourcer

Vores server-side adaptere er fuldt ud beskrevet i den tekniske vejledning. Den tekniske vejledning er tilgængelig i Queue-Fair Portal > Hjælp-sektionen, eller du kan anmode om et eksemplar fra os. Du kan også finde flere oplysninger om hver af adapterne i README.md for hvert GitHub-repositorium.


Adaptere til netværkskanten

Queue-Fair Network-Edge Adapters kører inden for din CDN- eller Cloud Services-udbyders ramme i stedet for i de besøgendes browsere eller på din origin-server.

Adaptere til Lambda- og CDN-udbydere

Dette giver den samme sikkerhed som Server-Side Adapter og den samme belastningsbeskyttelse som Direct Link.

Tilføjelse af Queue-Fair Network-Edge Adapter-bibliotekerne tager kun et par minutter med minimale kodeændringer hos din cloud-udbyder for at aktivere og køre adapteren, som normalt implementeres som en Lambda-funktion eller Edge Worker.

Enkel og sikker tilstand

Som med vores server-sideadaptere kan vores netværksdelsadaptere fungere i simpel eller sikker tilstand.

Tilgængelige adaptere

Amazon AWS CloudFront Network-Edge-adapter til virtuelle venteværelser') ?>

CloudFront

Amazon AWS CloudFront Network-Edge Virtual Waiting Room Adapter.

Cloudflare Network-Edge-adapter til virtuelle venteværelser

Cloudflare

Cloudflare Network-Edge-adapter til virtuelle venteværelser

Fastly Network-Edge-adapter til virtuelle venteværelser

Fastly

Fastly Network-Edge Virtual Waiting Room Adapter..

Akamai Network-Edge-adapter til virtuelle venteværelser

Akamai

Akamai Network-Edge Virtual Waiting Room Adapter.



Dynamiske kø-sider

Ligesom med Client-Side Adapter kan alle data, du ønsker, sendes fra dit websted til vores servere og de kø-sider, som dine besøgende ser, ved at sende disse oplysninger i Adapter-kaldet. Dette letter dynamisk kø-side eller anden tilpasning i farten på samme måde - alle funktioner i Client-Side Adapter er fuldt understøttet. Kontakt venligst support, hvis du ønsker at aktivere dynamiske kø-sider på din konto.

Network-Edge Adapter Yderligere ressourcer

Vores Network-Edge-adaptere er fuldt ud beskrevet i den tekniske vejledning. Den tekniske vejledning er tilgængelig i Queue-Fair Portal > Hjælp-sektionen, eller du kan anmode om et eksemplar fra os. Du kan også finde flere oplysninger om hver af adapterne i README.md for hvert GitHub-repository.


REST API'er

Queue-Fair giver udviklere adgang til seks REST API-moduler. Du skal have en Queue-Fair-konto for at bruge API'en. Kontakt Queue-Fair Support for at aktivere API-adgang for din konto. Vores REST API-moduler er i overensstemmelse med OpenAPI-, RFC 7807- og RFC 3339-standarderne.

Vores pakke af API-moduler er omfattende - alt, hvad du kan gøre i portalen, kan du også gøre med API'et, bortset fra at administrere portalbrugere, hvilket er udelukket af hensyn til privatlivets fred.

Hvert API-modul er fuldt dokumenteret på api.queue-fair.net, hvor du også finder en Swagger-grænseflade for at gøre det nemt at bruge og teste. Af sikkerhedshensyn er alle API-opkald beskyttet af sikker TLS-kryptering og kræver en API-nøgle, der er specifik for din konto.

API-moduler

API til rapportering

Til live-rapporter i realtid, historiske rapporter og aggregerede køstatistikker.

API til forvaltning af køer

Til oprettelse og ændring af køer programmatisk i realtid.

API til kontoadministration

Til visning og opdatering af dine indstillinger for hele kontoen.

API til forvaltning af aktiver

Til styring af de aktiver, der bruges af dine kø-sider, som serveres af Google CDN.

Præsentations-API

Til ændring af alle aspekter af HTML-siderne på dine kø-sider og til opdatering og oprettelse af varianter i farten.

Aktivering API

Til konfiguration af de aktiveringsregler, der bestemmer, hvilke sider på dit websted der kan udløse en kø, og hvilken side der vises.



Dynamiske kø-sider

Du kan også ændre dine kø-sider i farten uden at skulle opdatere databasen ved hjælp af portal- eller præsentations-API'en - kontakt support for yderligere oplysninger og for at aktivere dynamiske kø-sider på din konto.

REST API Yderligere ressourcer

Som krævet i RFC 7807 kan du finde dokumentation om fejlmeddelelser, der kan returneres af vores REST API-moduler, på queue-fair.com/api-error


Native apps

Queue-Fair ser godt ud på mobile browsere såvel som på stationære og bærbare computere.

Du kan også bruge Queue-Fair direkte i dine native iOS- og Android-apps samt React Native-apps på iOS, Android, Windows og MacOS for at beskytte ressourcekrævende aktiviteter eller operationer.

Queue-Fair App Adapters bruger en WebClient til at vise brugerdefinerede kø-displays til dine brugere, når dine tjenester er for travle, med den fleksibilitet og brugervenlighed, der kendetegner den Queue-Fair Portal.

Du kan sætte brugerne i samme kø som de besøgende på dit websted eller oprette en separat kø for dine app-brugere - det er op til dig.

Ligesom vores webbaserede køer gemmes hver brugers plads automatisk, hvis de navigerer væk fra din app.

GitHub-repositorier

iOS, MacOS og Apple Virtual Waiting Room Adapter

iOS & MacOS

GitHub-repositoriet for Queue-Fair Virtual Waiting Room iOS- og MacOS-adapteren.

Android-adapter til virtuelt venteværelse

Android

GitHub-repositoriet for Queue-Fair Virtual Waiting Room Adapter til Android.

React Native-app Virtual Waiting Room Adapter

React Native

GitHub-repositoriet for Queue-Fair Virtual Waiting Room Adapter til React Native-apps til Android, iOS, MacOS og Windows.

Meddelelser om køer

Queue-Fair-adapteren gør det nemt at sende push-meddelelser til brugere, der ikke bruger din app eller kø, når det er deres tur, der kaldes. Brugerens plads i køen gemmes automatisk vedvarende af adapteren i din app. Hvis brugeren navigerer væk fra din app, fortæller din app din Push Notification-server, at der skal sendes en meddelelse, og sender de gemte oplysninger om køens position som en del af meddelelsen til din Push Notification-server.

Det er den samme teknologi, som vi bruger til vores WeQ4U-app til forbrugerne, der alene i Storbritannien er blevet downloadet omkring 2 millioner gange.

Din Push Notification-server konsulterer Queue-Fair Status API med jævne mellemrum for at spørge om den køposition, der i øjeblikket betjenes. Når denne er større end en bestemt brugers køposition, er det tid til at sende den pågældende bruger meddelelsen. Hvis brugeren vender tilbage til køen eller er Passed, før der er blevet sendt en Push Notification, giver adapteren besked til din app, og din app fortæller din Push Notification-server, at meddelelsen ikke længere er nødvendig.

Så vidt vi ved, er vi den eneste udbyder af virtuelle venteværelser, der understøtter denne funktion.

Videoressourcer

Her er en video af Native App Adapter i aktion, der viser, at brugerens plads gemmes, selv om appen er helt stoppet, og som også viser de adapterkroge, som din app bruger til at sende push-meddelelser.

Yderligere ressourcer

Vores Native App Adapters er beskrevet i den tekniske vejledning. Den tekniske vejledning er tilgængelig i Queue-Fair Portal > Hjælp, eller du kan anmode om et eksemplar hos os. Du kan også finde flere oplysninger om hver af adapterne, der er specifikke for iOS og Android, i README.md for hvert GitHub-repositorium.


Adaptere til e-handel

Queue-Fair kan nemt tilføjes til ethvert e-handelssystem ved hjælp af den Client-Side JavaScript Adapter, der er beskrevet ovenfor.

Vi tilbyder også Adapterkode til at arbejde på serversiden med mange populære e-handelsservere.

GitHub-repositorier

Magento Plugin

Magento

GitHub-repositoriet for Queue-Fair Virtual Waiting Room Adapter for Magento.

WooCommerce/PHP Adapter til virtuelt venteværelse

WooCommerce

GitHub-repositoriet for Queue-Fair Virtual Waiting Room Adapter for WooCommerce i PHP.

PrestaShop/PHP Adapter til virtuelt venteværelse

PrestaShop

GitHub-repositoriet for Queue-Fair Virtual Waiting Room Adapter for PrestaShop i PHP.

Yderligere ressourcer

Vores adaptere er beskrevet i den tekniske vejledning. Den tekniske vejledning er tilgængelig i Queue-Fair Portal > Hjælp-sektionen, eller du kan anmode om et eksemplar hos os.

Vi har også supplerende vejledninger til de fleste e-handelsplatforme - du skal blot spørge efter den, du ønsker.


Hybrid sikkerhed

Du kan nemt kombinere fleksibiliteten i Client-Side JavaScript Adapter med det ekstra sikkerhedslag, som vores Server-Side-kode giver dig.

Queue-Fair signerer hver besøgende, vi passerer, med et digitalt fingeraftryk, som er unikt for den pågældende besøgende. Som noget unikt i branchen indeholder signaturen også en kode, der er specifik for den besøgendes browser, for at forhindre, at adgangstokens deles.

Din webserver kan validere signaturen ved hjælp af en hemmelighed, som kun du og vi kender - ikke dine besøgende - for at sikre, at hver enkelt besøgende er blevet passeret på en retfærdig måde af Queue-Fair-serverne.

Så du kan bruge JavaScript-adapteren på klientsiden til at sende og modtage besøgende til og fra køen og kontrollere for manipulation, før de bestiller, med minimal kode på serversiden og undgå at indføre en afhængighed af vores system.

Der findes eksempelkode i vores GitHub-repositories i alle større webprogrammeringssprog.

GitHub-repositorier

PHP

PHP

GitHub-repositoriet for Queue-Fair Virtual Waiting Room Server-Side Adapter i PHP.

Java

Java

GitHub-repositoriet for Queue-Fair Virtual Waiting Room Server-Side Adapter for Java, herunder JBoss og Tomcat.

Ruby

Ruby

GitHub-repositoriet for Queue-Fair Virtual Waiting Room Server-Side Adapter i Ruby og (valgfrit) Rails.

Python

Python

GitHub-repositoriet for Queue-Fair Virtual Waiting Room Server-Side Adapter i Python og (valgfrit) Django.

.NET

.NET

GitHub-repositoriet for Queue-Fair Virtual Waiting Room Server-Side Adapter for .NET, ASP og C#.

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

Node.js & JavaScript

GitHub-repositoriet for Queue-Fair Virtual Waiting Room Server-Side Adapter for Node.js og (eventuelt) Express.

Yderligere ressourcer

Den hybride sikkerhedsmodel er beskrevet i sin helhed i den tekniske vejledning. Den tekniske vejledning er tilgængelig i Queue-Fair Portal > Hjælp-sektionen, eller du kan anmode om et eksemplar hos os.


Licens

Vores offentliggjorte kode, der er tilgængelig på GitHub Queue-Fair Repository, er licenseret under MIT-licensen, som er blandt de mest tilladte open source-licenser.


Vil du vide, hvordan Queue-Fair fungerer?