Resurser för utvecklare

Google Tag Manager

GitHub-förrådet för Queue-Fair Virtual Waiting Room Google Tag Manager Client-Side Adapter Tag.

Dynamiska kö-sidor

Alla data du vill kan skickas från din webbplats till vårt kösystem och de kösidor som dina besökare ser genom att använda attributet data-queue-fair-extra som finns tillgängligt i klientsidans JavaScript-tagg och i Google Tag Manager-implementationen. Kontakta supporten om du vill aktivera dynamiska kösidor på ditt konto.

Du kan använda den här funktionen för att anpassa kö-sidor i farten. Du kan också använda Queue-Fair för att skicka data som du skickar till oss med dina besökare tillbaka till din webbplats när de passerar kön, vilket ger ytterligare säkerhet.

Vi tillhandahåller också ett API för dynamiska kösidor som använder de extra uppgifterna för att anpassa alla aspekter av en kösida, så att du kan skapa en kö för hela din webbplats och anpassa den automatiskt för olika händelser eller produkter på din webbplats, utan att behöva göra några ändringar i dina kösidor i Queue-Fair-portalen.

Köhantering för Shopify, WooCommerce och Wordpress

Om du använder en Wordpress-baserad webbplats, t.ex. varukorgssystemet WooCommerce, kan du enkelt lägga till JavasScript-adaptertaggen på klientsidan med hjälp av Wordpress Insert Headers & Footers Plugin, utan att behöva ändra dina teman eller mallar eller röra någon Wordpress-kod.

Ladda bara ner Insert Headers & Footers Plugin, packa upp den till din /wp-content/plugins/-mapp, aktivera pluginet i Plugins-menyn, öppna pluginet från Inställningar-menyn, lägg till taggen till Scripts i Header som visas, klicka på Save längst ner på sidan och du är klar! Wordpress köhantering förenklad. Det finns andra Wordpress-plugins som du kan använda för att lägga till taggen också - det här är det mest populära.

Vissa Wordpress-klienter vill lägga till Queue-Fair JavaScript-taggen på sina Wordpress-felsidor, vilket du kan göra genom att redigera /wp-includes/functions.php - lägg till den i HTML-koden i funktionen _default_wp_die_handler i den filen.

Shopify är lika enkelt - här är instruktioner för att lägga till Queue-Fair Client-Side JavaScript Adapter till din Shopify-butik - använd de tre punkterna längst upp till vänster efter att ha tryckt på Anpassa för att redigera kod i din theme.liquid Layout-fil.

Virtuellt väntrum på klientsidan i SquareSpace

Client-Side JavaScript Adapter är också mycket lätt att lägga till på din SquareSpace-webbplats - logga in och välj din webbplats, sedan Website från vänster nav, Website Tools (i avsnittet Utilities i vänster nav), Code Injection och sedan kopiera och klistra in den i Header-rutan och sedan Save längst upp till vänster.

För maximal säkerhet på SquareSpace, använd vår SquareSpace Network-Edge Adapter, som beskrivs nedan.

Klientsidans adapter Ytterligare resurser

Klientsidans adapter beskrivs fullständigt i den tekniska handboken. Den tekniska handboken finns tillgänglig i Queue-Fair Portal > Hjälp-sektionen, eller så kan du begära ett exemplar från oss.

Medan klientsidans adapter körs i JavaScript i besökarnas webbläsare körs Queue-Fair:s serversidans adaptrar på din webbserver.Detta innebär att dina servrar kan skicka besökare till kön mer effektivt. Dåliga aktörer kommer inte att se innehåll från din webbplats, men botar kan fortfarande göra förfrågningar till dina servrar, så för fullständigt DDoS-skydd, använd en av våra Network-Edge Adapters nedan.

Adaptrar för webbserver

Detta innebär att din webbserver kan utnyttja ytterligare säkerhetsfunktioner för att neka åtkomst till personer som inte har ställts i kö. Det innebär också att webbservern slipper belastningen från att generera och servera sidor som innehåller Adapter-skript.

Att lägga till biblioteken för Queue-Fair Server-Side Adapter tar bara några minuter med minimala kodändringar för att aktivera och köra adaptern.

De flesta av våra kunder börjar med klientsidans JavaScript-adapter och går över till serveradaptern endast när det finns en specifik funktionalitet eller ett affärsbehov.

Enkelt och säkert läge

Queue-Fair Server-Side Adapters kan fungera i enkelt eller säkert läge.

I det enkla läget skickas alla besökare till Queue-Fair-servrarna för att räknas, oavsett om en kö har bildats eller inte. Om det finns en kö, ansluter de sig till kön. När det inte finns någon kö skickas de tillbaka till din webbserver direkt, utan att se en kö-sida - men med den signatur som din webbserver behöver för att se till att endast personer som har passerat kön kan få tillgång till dina skyddade resurser.

I säkert läge skickas besökare endast till Queue-Fair-servrarna när det finns en kö. Din webbserver kontaktar direkt våra köservrar i bakgrunden för att avgöra detta. Besökarna signeras fortfarande digitalt på ett säkert sätt oavsett om de ansluter sig till en kö eller om de passerar utan att se en kö-sida eftersom kön är tom.

Säkert läge rekommenderas för dagliga köer. Enkelt läge är lämpligt för tidsbestämda evenemang eller försäljningar när du väntar tusentals personer, eftersom det eliminerar latenstiden på grund av kontrollsamtalet från din webbserver till våra köservrar, vilket innebär att du kan skicka personer till köerna mer effektivt.

GitHub-arkiv

PHP

GitHub-förrådet för Queue-Fair Virtual Waiting Room Server-Side Adapter i PHP.

Java

GitHub-förrådet för Queue-Fair Virtual Waiting Room Server-Side Adapter för Java, inklusive JBoss och Tomcat.

Ruby

GitHub-förrådet för Queue-Fair Virtual Waiting Room Server-Side Adapter i Ruby och (eventuellt) Rails.

Python

GitHub-arkiv för Queue-Fair Virtual Waiting Room Server-Side Adapter i Python och (eventuellt) Django.

.NET

GitHub-förrådet för Queue-Fair Virtual Waiting Room Server-Side Adapter för .NET, ASP och C#.

Node.js & JavaScript

GitHub-arkiv för Queue-Fair Virtual Waiting Room Server-Side Adapter för Node.js och (eventuellt) Express.

Dynamiska kö-sidor

Precis som med klientsidans adapter kan alla data du vill skickas från din webbserver till våra servrar och till de kösidor som dina besökare ser genom att skicka informationen i anropet till den serverbaserade adaptern när personer ansluter sig till kön. Detta underlättar dynamisk kösida eller annan anpassning i farten på samma sätt - alla funktioner i Client-Side Adapter stöds fullt ut. Kontakta supporten om du vill aktivera Dynamic Queue Pages på ditt konto.

Server-Side Adapter Ytterligare resurser

Våra serverbaserade adaptrar beskrivs utförligt i den tekniska guiden. Den tekniska handboken finns tillgänglig i Queue-Fair Portal > Hjälp-sektionen, eller så kan du begära ett exemplar från oss. Du kan också hitta mer information om varje adapter i README.md för varje globalt GitHub community repository.

Queue-Fair Network-Edge Adapters körs i din CDN- eller molntjänstleverantörs ramverk, snarare än i besökarnas webbläsare eller på din ursprungsserver. Detta är det bästa sättet att använda Queue-Fair för att skydda dina servrar från botattacker, inklusive DDoS-attacker.

Adaptrar för Lambda- och CDN-leverantörer

Detta ger samma funktionalitet och säkerhet som Server-Side Adapter och samma belastningsskydd som Direct Link.

Att lägga till biblioteken för Queue-Fair Network-Edge Adapter tar bara några minuter med minimala kodändringar hos din molnleverantör för att aktivera och köra adaptern, som normalt distribueras som en Lambda-funktion eller Edge Worker.

Enkelt och säkert läge

Precis som våra serverbaserade adaptrar kan våra nätverkskantadaptrar fungera i enkelt eller säkert läge.

Tillgängliga adaptrar

CloudFront

Amazon AWS CloudFront Network-Edge Virtual Waiting Room Adapter.

Cloudflare

Cloudflare Network-Edge Adapter för virtuellt väntrum

Fastly

Fastly Network-Edge Virtual Waiting Room Adapter..

Akamai

Akamai Network-Edge Adapter för virtuellt väntrum.

Dynamiska kö-sidor

Precis som med klientsidans adapter kan alla data du vill skickas från din webbplats till våra servrar och de kösidor som dina besökare ser genom att skicka informationen i adapteranropet. Detta underlättar dynamisk kösida eller andra anpassningar i farten när människor ansluter sig till kön på samma sätt - alla funktioner i Client-Side Adapter stöds fullt ut. Kontakta supporten om du vill aktivera Dynamic Queue Pages på ditt konto.

Nätverkskantadapter Ytterligare resurser

Våra nätverksadaptrar beskrivs utförligt i den tekniska guiden. Den tekniska guiden finns tillgänglig i Queue-Fair Portal > Hjälp-sektionen, eller så kan du begära ett exemplar från oss. Du kan också hitta mer information om varje adapter i README.md i varje globalt GitHub community repository.

Queue-Fair ger utvecklare tillgång till sex REST API-moduler. Du behöver ett Queue-Fair-konto för att använda API:et. Kontakta Queue-Fair Support för att aktivera API-åtkomst för ditt konto. Våra REST API-moduler överensstämmer med standarderna OpenAPI, RFC 7807 och RFC 3339.

Vårt utbud av API-moduler är omfattande - allt du kan göra i portalen kan du också göra med API:et, förutom att hantera portalanvändare, vilket är uteslutet av integritetsskäl.

Varje API-modul är fullständigt dokumenterad på api.queue-fair.net, där du också hittar ett Swagger-gränssnitt för att underlätta användning och testning. För säkerhets skull skyddas alla API-samtal av säker TLS-kryptering och kräver en API-nyckel som är specifik för ditt konto.

API-moduler

Dynamiska kö-sidor

Du kan också ändra dina kösidor i farten utan att behöva uppdatera databasen med hjälp av portal- eller presentations-API:n. Kontakta supporten för mer information och för att aktivera dynamiska kösidor på ditt konto.

REST API Ytterligare resurser

I enlighet med RFC 7807 kan du hitta dokumentation om felmeddelanden som kan returneras av våra REST API-moduler på queue-fair.com/api-error.

Queue-Fair ser bra ut på mobila webbläsare såväl som på stationära och bärbara datorer.

Du kan också använda Queue-Fair direkt i dina iOS- och Android-appar och React Native-appar på iOS, Android, Windows och MacOS för att skydda resurskrävande aktiviteter eller verksamheter.

Queue-Fair App Adapters använder en WebClient för att ansluta appar och visa anpassade köbilder för användarna när tjänsterna är för upptagna, med den flexibilitet och användarvänlighet som finns i Queue-Fair Portal.

Du kan ställa användare i samma kö som besökare på din webbplats eller skapa en separat kö för appanvändare - det är upp till dig.

Precis som i våra webbaserade köer sparas varje användares plats automatiskt när de väl har anslutit sig till kön, även om de navigerar bort från appen.

GitHub-arkiv

iOS & MacOS

GitHub-förrådet för Queue-Fair Virtual Waiting Room iOS- och MacOS-adaptern.

Android

GitHub-arkiv för Queue-Fair Virtual Waiting Room Adapter för Android.

React Native

GitHub-förrådet för Queue-Fair-adaptern för virtuellt väntrum för React Native-appar för Android, iOS, MacOS och Windows.

Meddelanden om köer

Queue-Fair-adaptern har callbacks som gör det enkelt att skicka push-notiser till användare som inte använder din app eller kö när deras tur kallas. Användarens plats i kön lagras automatiskt och permanent av adaptern i din app. Om användaren navigerar bort från din app talar din app om för din Push Notification-server att ett meddelande ska skickas och skickar den lagrade informationen om köpositionen som en del av meddelandet till din Push Notification-server.

Det är samma teknik som vi använder för vår WeQ4U-app och -tjänst för konsumenter, som har laddats ner cirka 2 miljoner gånger bara i Storbritannien.

Din Push Notification-server konsulterar Queue-Fair Status API regelbundet för att fråga efter den köposition som för närvarande betjänas. När detta är större än en viss användares köposition är det dags att kontakta användaren med meddelandet. Om användaren återvänder till kön eller passerar innan ett push-notifieringsmeddelande har skickats, meddelar callbacks i adaptern din app och din app meddelar din push-notifieringsserver att meddelandet inte längre behövs.

Såvitt vi vet är vi den enda leverantören av virtuella väntrum som stöder den här funktionen.

Videoresurser

Här är en video med Native App Adapter i aktion som visar att användarens plats sparas även om appen stoppas helt och hållet, och som även visar de Adapterkrokar som din app använder för att skicka push-notiser.

Ytterligare resurser

Våra Native App Adapters beskrivs i den tekniska guiden. Den tekniska guiden finns tillgänglig i Queue-Fair Portal > Hjälp, eller så kan du begära ett exemplar från oss. Du kan också hitta mer information om varje adapter som är specifik för iOS och Android i README.md i varje globalt GitHub community repository.

Queue-Fair kan enkelt läggas till i alla e-handelssystem med hjälp av den klientsidiga JavaScript-adapter som beskrivs ovan.

Vi erbjuder också Adapterkod för att fungera på serversidan med många populära e-handelsservrar.

GitHub-arkiv

Magento

GitHub-förrådet för Queue-Fair Virtual Waiting Room Adapter för Magento.

WooCommerce

GitHub-förrådet för Queue-Fair Virtual Waiting Room Adapter för WooCommerce i PHP.

PrestaShop

GitHub-förrådet för Queue-Fair Virtual Waiting Room Adapter för PrestaShop i PHP.

SquareSpace

GitHub-arkivet för Queue-Fair Virtual Waiting Room Adapter för SquareSpace.

Ytterligare resurser

Våra adaptrar beskrivs i den tekniska guiden. Den tekniska handboken finns i Queue-Fair Portal > Hjälp-sektionen, eller så kan du begära ett exemplar från oss.

Vi har också kompletterande guider för de flesta e-handelsplattformar - fråga bara efter den du vill ha.

Du kan enkelt kombinera flexibiliteten hos klientsidans JavaScript-adapter med det extra säkerhetslager som vår serverkod erbjuder.

Queue-Fair signerar varje besökare som vi passerar med ett digitalt fingeravtryck som är unikt för den besökaren. Signaturen innehåller också en kod som är specifik för besökarens webbläsare, vilket är unikt i branschen, för att förhindra att åtkomsttoken delas.

Din webbserver kan validera signaturen med hjälp av en hemlighet som endast du och vi känner till - inte dina besökare - för att säkerställa att varje besökare har passerat Queue-Fair-servrarna på ett rättvist sätt.

Du kan alltså använda JavaScript-adaptern på klientsidan för att skicka och ta emot besökare till och från kön och kontrollera om de har manipulerats innan de beställer med minimal kod på serversidan och undvika att införa ett beroende av vårt system.

Exempelkoder finns i våra globala GitHub-arkiv för alla större webbprogrammeringsspråk.

GitHub-arkiv

PHP

GitHub-förrådet för Queue-Fair Virtual Waiting Room Server-Side Adapter i PHP.

Java

GitHub-förrådet för Queue-Fair Virtual Waiting Room Server-Side Adapter för Java, inklusive JBoss och Tomcat.

Ruby

GitHub-förrådet för Queue-Fair Virtual Waiting Room Server-Side Adapter i Ruby och (eventuellt) Rails.

Python

GitHub-arkiv för Queue-Fair Virtual Waiting Room Server-Side Adapter i Python och (eventuellt) Django.

.NET

GitHub-förrådet för Queue-Fair Virtual Waiting Room Server-Side Adapter för .NET, ASP och C#.

Node.js & JavaScript

GitHub-arkiv för Queue-Fair Virtual Waiting Room Server-Side Adapter för Node.js och (eventuellt) Express.

Ytterligare resurser

Den hybrida säkerhetsmodellen beskrivs utförligt i den tekniska guiden. Den tekniska guiden finns tillgänglig i Queue-Fair-portalen > avsnittet Hjälp, eller så kan du begära ett exemplar från oss.

Vår publicerade kod som finns tillgänglig på GitHub Queue-Fair Repository är licensierad enligt MIT-licensen, som är bland de mest tillåtande licenserna för öppen källkod för det globala samfundet.