Zdroje pro vývojáře

Správce značek Google

Úložiště GitHub pro značku Queue-Fair Virtual Waiting Room Google Tag Manager Client-Side Adapter Tag.

Dynamické stránky fronty

Pomocí atributu data-queue-fair-extra, který je k dispozici v klientské značce JavaScript a v implementaci Google Tag Manager, lze z vašeho webu předat jakákoli data do našeho systému fronty a na stránky fronty, které návštěvníci vidí. Pokud chcete na svém účtu povolit dynamické stránky fronty, kontaktujte prosím podporu.

Tuto funkci můžete použít k průběžnému přizpůsobení stránek fronty. Pomocí Queue-Fair můžete také předávat data, která nám posíláte s návštěvníky, zpět na vaše stránky, když procházejí frontou, a získat tak další úroveň zabezpečení.

Poskytujeme také rozhraní API pro dynamické stránky fronty, které využívá dodatečné údaje k přizpůsobení jakéhokoli aspektu stránky fronty, takže můžete vytvořit jednu frontu pro celý web a automaticky ji přizpůsobovat různým událostem nebo produktům na webu, aniž byste museli provádět jakékoli změny na svých stránkách fronty na portálu Queue-Fair.

Správa front Shopify, WooCommerce a Wordpress

Pokud používáte stránky založené na systému Wordpress, jako je například nákupní košík WooCommerce, můžete snadno přidat značku Client-Side JavasScript Adapter pomocí pluginu Wordpress Insert Headers & Footers, aniž byste museli upravovat některý z motivů nebo šablon nebo se dotýkat kódu Wordpress.

Stačí stáhnout plugin Insert Headers & Footers, rozbalit jej do složky /wp-content/plugins/, aktivovat plugin v nabídce Plugins, otevřít plugin v nabídce Settings, přidat značku do Scripts in Header (Skripty v záhlaví ), jak je uvedeno na obrázku, stisknout Save (Uložit) v dolní části stránky a je hotovo! Jednoduchá správa front Wordpress. Existují i další pluginy Wordpress, které můžete použít k přidání značky - tento je nejoblíbenější.

Někteří klienti Wordpressu rádi přidávají značku Queue-Fair JavaScript také na své chybové stránky Wordpressu, což můžete provést úpravou souboru /wp-includes/functions.php - přidejte ji do HTML obsaženého ve funkci _default_wp_die_handler v tomto souboru.

Shopify je stejně snadné - zde jsou pokyny pro přidání Queue-Fair Client-Side JavaScript Adapter do vašeho obchodu Shopify - použijte tři tečky vlevo nahoře po stisknutí tlačítka Přizpůsobit a upravte kód v souboru theme.liquid Layout.

Virtuální čekárna SquareSpace na straně klienta

Adaptér JavaScriptu na straně klienta lze také velmi snadno přidat na web služby SquareSpace - přihlaste se a vyberte svůj web, poté Webové stránky v levém navigačním okně, Nástroje webu (v sekci Nástroje v levém navigačním okně), Vstřikování kódu a poté jej zkopírujte a vložte do pole Záhlaví a poté vlevo nahoře Uložit.

Pro maximální zabezpečení na platformě SquareSpace použijte náš adaptér SquareSpace Network-Edge Adapter, který je popsán níže.

Adaptér na straně klienta Další zdroje

Adaptér na straně klienta je podrobně popsán v Technické příručce. Technická příručka je k dispozici na portálu Queue-Fair > v části Nápověda nebo si můžete vyžádat její kopii u nás.

Zatímco adaptér na straně klienta běží v prohlížeči návštěvníků v jazyce JavaScript, adaptéry Queue-Fair na straně serveru běží na vašem webovém serveru.To znamená, že vaše servery mohou efektivněji odesílat návštěvníky do fronty. Zlí hráči neuvidí obsah vašeho webu, nicméně boti mohou stále zadávat požadavky na vaše servery, takže pro úplnou ochranu proti DDoS použijte jeden z našich adaptérů na hraně sítě uvedených níže.

Adaptéry webového serveru

To znamená, že váš webový server může využívat další funkce zabezpečení a odepřít přístup osobám, které nebyly zařazeny do fronty. To také znamená, že se váš webový server vyhne zátěži spojené s generováním a zobrazováním stránek obsahujících skript Adapter.

Přidání knihoven Queue-Fair Server-Side Adapter zabere jen několik minut s minimálními změnami kódu pro aktivaci a spuštění Adaptéru.

Většina našich zákazníků začíná s adaptérem JavaScript na straně klienta a přechází na adaptér na straně serveru pouze v případě specifické funkce nebo obchodní potřeby.

Jednoduchý a bezpečný režim

Adaptéry na straně serveru Queue-Fair mohou pracovat v jednoduchém nebo bezpečném režimu.

V jednoduchém režimu jsou všichni návštěvníci odesláni na servery Queue-Fair, kde se započítají, bez ohledu na to, zda se vytvořila fronta. Pokud je fronta vytvořena, připojí se do ní. Když fronta není, jsou rovnou vráceni na webový server, aniž by se jim zobrazila stránka fronty - ale s podpisem, který váš webový server potřebuje k zajištění toho, aby k vašim chráněným prostředkům měli přístup pouze lidé, kteří prošli frontou.

V nouzovém režimu jsou návštěvníci odesíláni na servery Queue-Fair pouze v případě, že je k dispozici fronta. Váš webový server se při tomto rozhodování obrací přímo na naše servery fronty na pozadí. Návštěvníci jsou stále bezpečně digitálně podepsáni bez ohledu na to, zda se připojí k frontě, nebo zda jsou předáni bez zobrazení stránky fronty, protože fronta je prázdná.

Nouzový režim se doporučuje pro každodenní fronty. Jednoduchý režim je vhodný pro časově omezené události nebo prodej, kdy očekáváte tisíce lidí, protože eliminuje zpoždění způsobené kontrolním voláním z vašeho webového serveru na naše servery fronty, což znamená, že můžete efektivněji posílat lidi, aby se připojili do fronty.

Úložiště GitHub

PHP

Úložiště GitHub pro virtuální čekárnu Queue-Fair na straně serveru v jazyce PHP.

Java

Úložiště GitHub pro adaptér Queue-Fair Virtual Waiting Room na straně serveru pro Javu, včetně JBoss a Tomcat.

Ruby

Úložiště GitHub pro virtuální čekárnu Queue-Fair na straně serveru v jazyce Ruby a (volitelně) Rails.

Python

Úložiště GitHub pro adaptér virtuální čekárny Queue-Fair na straně serveru v jazyce Python a (volitelně) Django.

.NET

Úložiště GitHub pro virtuální čekárnu Queue-Fair na straně serveru pro .NET, ASP a C#.

Node.js & JavaScript

Úložiště GitHub pro adaptér virtuální čekárny Queue-Fair na straně serveru pro Node.js a (volitelně) Express.

Dynamické stránky fronty

Stejně jako v případě adaptéru na straně klienta lze z vašeho webového serveru předat na naše servery a na stránky fronty, které se návštěvníkům zobrazí, jakákoli data, a to předáním těchto informací ve volání adaptéru na straně serveru při vstupu do fronty. To usnadňuje dynamické přizpůsobení stránky fronty nebo jiné přizpůsobení za běhu stejným způsobem - všechny funkce adaptéru na straně klienta jsou plně podporovány. Pokud chcete na svém účtu povolit dynamické stránky fronty, kontaktujte prosím podporu.

Další zdroje adaptéru na straně serveru

Naše adaptéry na straně serveru jsou podrobně popsány v technické příručce. Technická příručka je k dispozici na portálu Queue-Fair > v části Nápověda nebo si můžete vyžádat její kopii u nás. Další informace o jednotlivých adaptérech najdete také v souboru README.md každého globálního komunitního úložiště GitHub.

Adaptéry Queue-Fair Network-Edge běží v rámci CDN nebo poskytovatele cloudových služeb, nikoli v prohlížečích návštěvníků nebo na vašem původním serveru. To je nejlepší způsob, jak používat Queue-Fair k ochraně serverů před útoky botů, včetně útoků DDoS.

Adaptéry poskytovatele Lambda a CDN

Poskytuje stejnou funkčnost a zabezpečení jako adaptér na straně serveru a stejnou ochranu proti zatížení jako Direct Link.

Přidání knihoven síťového adaptéru Queue-Fair Network-Edge Adapter zabere jen několik minut s minimálními změnami kódu u poskytovatele cloudu, aby bylo možné adaptér aktivovat a spustit, což je obvykle nasazeno jako funkce Lambda nebo Edge Worker.

Jednoduchý a bezpečný režim

Stejně jako naše adaptéry na straně serveru mohou naše síťové adaptéry pracovat v jednoduchém nebo bezpečném režimu.

Dostupné adaptéry

CloudFront

Adaptér virtuální čekárny Amazon AWS CloudFront Network-Edge.

Cloudflare

Adaptér virtuální čekárny Cloudflare Network-Edge

Fastly

Adaptér virtuální čekárny Fastly Network-Edge..

Akamai

Adaptér virtuální čekárny Akamai Network-Edge.

Dynamické stránky fronty

Stejně jako u adaptéru na straně klienta lze předáním těchto informací ve volání adaptéru předat z vašeho webu na naše servery a na stránky fronty, které se zobrazí návštěvníkům, jakákoli data, která si přejete. To usnadňuje dynamické přizpůsobení stránky fronty nebo jiné přizpůsobení za běhu, protože lidé se do fronty připojují stejným způsobem - všechny funkce adaptéru na straně klienta jsou plně podporovány. Pokud chcete na svém účtu povolit dynamické stránky fronty, kontaktujte prosím podporu.

Adaptér na okraji sítě Další zdroje

Naše síťové adaptéry jsou podrobně popsány v technické příručce. Technická příručka je k dispozici na portálu Queue-Fair > v části Nápověda nebo si můžete vyžádat její kopii u nás. Další informace o jednotlivých adaptérech najdete také v souboru README.md každého globálního komunitního úložiště GitHub.

Queue-Fair poskytuje vývojářům přístup k šesti modulům REST API. K používání rozhraní API potřebujete účet Queue-Fair. Chcete-li povolit přístup k rozhraní API pro svůj účet, obraťte se na podporu Queue-Fair. Naše moduly REST API odpovídají standardům OpenAPI, RFC 7807 a RFC 3339.

Naše sada modulů API je komplexní - vše, co můžete dělat v portálu, můžete dělat také pomocí rozhraní API, s výjimkou správy uživatelů portálu, která je z důvodu ochrany osobních údajů vyloučena.

Každý modul API je plně zdokumentován na adrese api.queue-fair.net, kde najdete také rozhraní Swagger pro snadné používání a testování. Z důvodu bezpečnosti jsou všechna volání API chráněna bezpečným šifrováním TLS a vyžadují klíč API, který je specifický pro váš účet.

Moduly API

Dynamické stránky fronty

Stránky fronty můžete také upravovat za běhu, aniž byste museli aktualizovat databázi pomocí rozhraní API portálu nebo prezentace - pro další podrobnosti a povolení dynamických stránek fronty na svém účtu kontaktujte podporu.

Další zdroje rozhraní REST API

V souladu s požadavkem RFC 7807 najdete dokumentaci o chybových hlášeních, která mohou být vrácena našimi moduly REST API, na adrese queue-fair.com/api-error.

Queue-Fair vypadá skvěle v mobilních prohlížečích i na stolních počítačích a noteboocích.

Queue-Fair můžete používat také přímo ve svých nativních aplikacích pro iOS a Android a také v aplikacích React Native pro iOS, Android, Windows a MacOS, abyste ochránili činnosti nebo operace náročné na zdroje.

Adaptéry aplikací Queue-Fair využívají webového klienta k připojení aplikací a zobrazení vlastních zobrazení fronty uživatelům, když jsou služby příliš vytížené, s flexibilitou a snadným použitím. Queue-Fair Portal.

Uživatele můžete zařadit do stejné fronty jako návštěvníky webu nebo pro uživatele aplikace vytvořit samostatnou frontu - záleží jen na vás.

Stejně jako u našich webových front se místo každého uživatele po jeho zařazení do fronty automaticky uloží, i když z aplikace odejde.

Úložiště GitHub

iOS & MacOS

Úložiště GitHub pro adaptér virtuální čekárny Queue-Fair pro iOS a MacOS.

Android

Úložiště GitHub pro adaptér virtuální čekárny Queue-Fair pro Android.

React Native

Úložiště GitHub pro adaptér virtuální čekárny Queue-Fair pro aplikace React Native pro Android, iOS, MacOS a Windows.

Oznámení fronty

Adaptér Queue-Fair má zpětná volání, která usnadňují odesílání oznámení Push uživatelům, kteří nepoužívají vaši aplikaci nebo frontu, když na ně přijde řada. Místo uživatele ve frontě je automaticky trvale uloženo adaptérem ve vaší aplikaci. Pokud uživatel odejde z vaší aplikace, vaše aplikace sdělí vašemu serveru Push Notification, že má být odesláno oznámení, a odešle uloženou informaci o pozici ve frontě jako součást této zprávy na váš server Push Notification.

Jedná se o stejnou technologii, kterou používáme pro naši spotřebitelskou aplikaci a službu WeQ4U, kterou si jen ve Velké Británii stáhly přibližně 2 miliony uživatelů.

Váš server Push Notification pravidelně konzultuje rozhraní API Queue-Fair Status a dotazuje se na pozici ve frontě, která je aktuálně obsluhována. Pokud je tato hodnota větší než pozice ve frontě konkrétního uživatele, je čas kontaktovat tohoto uživatele s oznámením. Pokud se uživatel vrátí do fronty nebo je Passed před odesláním oznámení Push Notification, zpětná volání v adaptéru upozorní vaši aplikaci a vaše aplikace sdělí serveru Push Notification, že oznámení již není potřeba.

Pokud je nám známo, jsme jediným poskytovatelem virtuální čekárny, který tuto funkci podporuje.

Video zdroje

Zde je video s adaptérem nativní aplikace v akci, které ukazuje, že místo uživatele je uloženo, i když je aplikace zcela zastavena, a také ukazuje háčky adaptéru, které aplikace používá k odesílání oznámení Push.

Další zdroje

Naše nativní adaptéry aplikací jsou popsány v technické příručce. Technická příručka je k dispozici na portálu Queue-Fair > v sekci Nápověda nebo si můžete vyžádat její kopii od nás. Další informace o každém z adaptérů, které jsou specifické pro systémy iOS a Android, najdete také v souboru README.md každého globálního komunitního úložiště GitHub.

Queue-Fair lze snadno přidat do jakéhokoli systému elektronického obchodování pomocí výše popsaného adaptéru JavaScript na straně klienta.

Nabízíme také adaptéry pro práci na straně serveru s mnoha populárními servery pro elektronické obchodování.

Úložiště GitHub

Magento

Úložiště GitHub pro adaptér virtuální čekárny Queue-Fair pro Magento.

WooCommerce

Repozitář GitHub pro adaptér virtuální čekárny Queue-Fair pro WooCommerce v PHP.

PrestaShop

Repozitář GitHub pro adaptér virtuální čekárny Queue-Fair pro PrestaShop v PHP.

SquareSpace

Úložiště GitHub pro adaptér virtuální čekárny Queue-Fair pro SquareSpace.

Další zdroje

Naše adaptéry jsou popsány v technické příručce. Technická příručka je k dispozici na portálu Queue-Fair > v sekci Nápověda nebo si můžete vyžádat její kopii u nás.

K dispozici máme také doplňkové průvodce pro většinu platforem elektronického obchodování - stačí požádat o ten, který chcete.

Můžete snadno kombinovat flexibilitu adaptéru JavaScript na straně klienta s dodatečnou vrstvou zabezpečení, kterou poskytuje náš kód na straně serveru.

Queue-Fair označí každého návštěvníka, kterého propustíme, digitálním otiskem prstu, který je pro daného návštěvníka jedinečný. Tento podpis, který je v tomto odvětví jedinečný, obsahuje také kód specifický pro prohlížeč návštěvníka, aby se zabránilo sdílení přístupových tokenů.

Váš webový server může ověřit podpis pomocí tajemství, které znáte pouze vy a my - nikoli vaši návštěvníci - a zajistit tak, že každý návštěvník prošel servery Queue-Fair spravedlivě.

Pomocí adaptéru JavaScript na straně klienta tak můžete odesílat a přijímat návštěvníky do fronty a z fronty a kontrolovat, zda nedošlo k manipulaci s objednávkou, s minimálním množstvím kódu na straně serveru a vyhnout se závislosti na našem systému.

V našich globálních komunitních repozitářích GitHub jsou k dispozici příklady kódu ve všech hlavních webových programovacích jazycích.

Úložiště GitHub

PHP

Úložiště GitHub pro virtuální čekárnu Queue-Fair na straně serveru v jazyce PHP.

Java

Úložiště GitHub pro adaptér Queue-Fair Virtual Waiting Room na straně serveru pro Javu, včetně JBoss a Tomcat.

Ruby

Úložiště GitHub pro virtuální čekárnu Queue-Fair na straně serveru v jazyce Ruby a (volitelně) Rails.

Python

Úložiště GitHub pro adaptér virtuální čekárny Queue-Fair na straně serveru v jazyce Python a (volitelně) Django.

.NET

Úložiště GitHub pro virtuální čekárnu Queue-Fair na straně serveru pro .NET, ASP a C#.

Node.js & JavaScript

Úložiště GitHub pro adaptér virtuální čekárny Queue-Fair na straně serveru pro Node.js a (volitelně) Express.

Další zdroje

Hybridní bezpečnostní model je podrobně popsán v Technické příručce. Technická příručka je k dispozici na portálu Queue-Fair > v části Nápověda nebo si můžete vyžádat její kopii u nás.

Náš zveřejněný kód dostupný v repozitáři GitHub Queue-Fair je licencován pod licencí MIT, která patří mezi nejpřísnější licence otevřeného softwaru pro celosvětovou komunitu.