Pridanie Queue-Fair
Virtuálna čakáreň Queue-Fair sa dá jednoducho pridať do rôznych webových platforiem a aplikácií v priebehu niekoľkých minút. Stačí použiť jeden z našich adaptérov. Viac informácií o najlepšom spôsobe integrácie služby Queue-Fair s existujúcim systémom nájdete v technickej príručke alebo v časti Portál Queue-Fair > Pomocník. Ak hľadáte informácie o tom, ako zabrániť botom alebo ľuďom v zadávaní viacnásobných príkazov alebo ako chrániť predaj NFT pred nadmernými poplatkami za plyn, môžete si prečítať tento prehľad alebo získať podrobné informácie v časti Sprievodca zabezpečením na portáli.
Najrýchlejší spôsob, ako začať pracovať s Queue-Fair, je zaregistrovať sa Bezplatná úroveň účet - môžete tak urobiť online a okamžite začať s integráciou a testovaním.
Potrebujete pomoc s nastavením sadzieb pre vašu frontu? Všetko, čo potrebujete vedieť, nájdete tu.
Adaptér na strane klienta
V prípade webových stránok je najjednoduchším spôsobom integrácie s Queue-Fair pridanie značky JavaScript Client-Side Queue-Fair Adapter na vaše stránky. Adaptér môžete bezpečne pridať na všetky stránky na svojom webe a pomocou aktivačných pravidiel na portáli Queue-Fair určiť, ktoré stránky môžu vyhadzovať fronty.
Náš adaptér na strane klienta v jazyku JavaScript je bezpečnejší ako integračné prvky na strane klienta od iných poskytovateľov. Keďže beží v prehliadačoch vašich návštevníkov, s adaptérom na strane klienta môžu manipulovať technicky zdatní návštevníci, ale je veľmi účinný pri prevencii preťaženia, pretože len veľmi malá časť ľudí sa pokúsi preskočiť frontu manipuláciou s JavaScriptom. Väčšina našich zákazníkov používa Client-Side Adapter, pretože je účinný pri prevencii pádu webu, jednoducho sa inštaluje a nezavádza žiadnu závislosť medzi naším a vaším systémom. Na rozdiel od integračných prvkov na strane klienta od iných poskytovateľov ho možno zabezpečiť proti manipulácii pomocou hybridného bezpečnostného modelu opísaného v technickej príručke.
Vrstvu zabezpečenia môžete pridať nahradením značky JavaScript adaptérom na strane servera alebo môžete skombinovať flexibilitu adaptéra JavaScript s hybridným modelom zabezpečenia opísaným na tejto stránke; obe metódy sú potom bezpečné.
Jeden riadok kódu
Ak chcete pridať adaptér na strane klienta na svoj web, stačí pridať nasledujúci riadok kódu do <head> sekcie vašich stránok:
Niektorí zákazníci pridávajú slovo defer k značke, čo spôsobí, že skript Adapter sa stiahne súbežne s analyzovaním stránky a spustí sa v prehliadači návštevníka až po dokončení analyzovania stránky (zvyčajne teda po dokončení všetkých ostatných skriptov na stránke).
Pridanie slova odložiť môže v niektorých prípadoch zlepšiť čas do prvého vymaľovania o malý zlomok sekundy, ale ak sa rozhodnete pre tento krok, bude to znamenať, že všetci návštevníci, ktorí by mali byť zaradení do frontu, uvidia vašu chránenú stránku o zlomok sekundy dlhšie, než budú odoslaní do frontu.
Správca značiek Google
Poskytujeme aj adaptér JavaScript Tag prostredníctvom služby Google Tag Manager. Vyhľadajte Queue-Fair v galérii šablón komunity v časti Pridať značku. Upozorňujeme, že niektoré blokovače reklám bránia stiahnutiu hlavného súboru gtm.js od spoločnosti Google, čo blokuje všetky operácie nástroja Google Tag Manager vrátane spustenia adaptéra systému radenia pre týchto návštevníkov.
Správca značiek Google
Úložisko GitHub pre virtuálnu čakáreň Queue-Fair Značka Google Tag Manager na strane klienta.
Dynamické stránky frontu
Všetky údaje, ktoré si želáte, môžete odovzdať z vášho webu do nášho systému fronty a na stránky fronty, ktoré vidia vaši návštevníci, pomocou atribútu data-queue-fair-extra, ktorý je k dispozícii v značke JavaScript na strane klienta a v implementácii nástroja Google Tag Manager. Ak chcete na svojom účte povoliť dynamické stránky frontu, obráťte sa na podporu.
Pomocou tejto funkcie môžete priebežne prispôsobovať stránky frontu. Queue-Fair môžete použiť aj na odovzdanie údajov, ktoré nám posielate spolu s návštevníkmi, späť na vašu stránku, keď prechádzajú frontom, čím získate ďalšiu úroveň zabezpečenia.
Poskytujeme aj rozhranie API pre dynamické stránky fronty, ktoré využíva dodatočné údaje na prispôsobenie akéhokoľvek aspektu stránky fronty, takže môžete vytvoriť jednu frontu pre celý web a automaticky ju prispôsobiť pre rôzne udalosti alebo produkty na vašom webe bez toho, aby ste museli vykonať akékoľvek zmeny na svojich stránkach fronty na portáli Queue-Fair.
Správa fronty Shopify, WooCommerce a Wordpress
Ak používate stránku založenú na systéme Wordpress, napríklad nákupný košík WooCommerce, môžete jednoducho pridať značku Client-Side JavasScript Adapter pomocou pluginu Wordpress Insert Headers & Footers bez toho, aby ste museli upravovať akékoľvek témy alebo šablóny alebo sa dotýkať kódu Wordpress.
Stačí si stiahnuť plugin Insert Headers & Footers, rozbaliť ho do priečinka /wp-content/plugins/, aktivovať plugin v ponuke Plugins, otvoriť plugin v ponuke Settings, pridať značku do Scripts in Header, ako je znázornené, stlačiť Save v dolnej časti stránky a je hotovo! Zjednodušená správa front Wordpress. Na pridanie značky môžete použiť aj iné pluginy Wordpress - tento je najobľúbenejší.
Niektorí klienti Wordpressu radi pridávajú značku Queue-Fair JavaScript aj na svoje chybové stránky Wordpressu, čo môžete urobiť úpravou súboru /wp-includes/functions.php - pridajte ju do HTML obsiahnutého vo funkcii _default_wp_die_handler v tomto súbore.
Shopify je rovnako jednoduché - tu sú pokyny na pridanie Queue-Fair Client-Side JavaScript Adapter do vášho obchodu Shopify - použite tri bodky vľavo hore po stlačení tlačidla Customise (Prispôsobiť) na úpravu kódu v súbore theme.liquid Layout.
Virtuálna čakáreň SquareSpace na strane klienta
Adaptér JavaScriptu na strane klienta sa tiež veľmi ľahko pridáva na vašu stránku SquareSpace - prihláste sa a vyberte svoju webovú stránku, potom Webovú stránku v ľavej navigačnej ponuke, Nástroje webovej stránky (v časti Nástroje v ľavej navigačnej ponuke), Vstreknutie kódu a potom ho skopírujte a vložte do poľa Hlavička a potom Uložiť vľavo hore.
Na dosiahnutie maximálneho zabezpečenia v službe SquareSpace použite náš adaptér SquareSpace Network-Edge Adapter, ktorý je opísaný nižšie.
Adaptér na strane klienta Ďalšie zdroje
Adaptér na strane klienta je podrobne opísaný v technickej príručke. Technická príručka je k dispozícii na portáli Queue-Fair > v časti Pomocník alebo si môžete vyžiadať jej kópiu od nás.
Adaptéry na strane servera
Zatiaľ čo adaptér na strane klienta beží v jazyku JavaScript v prehliadačoch návštevníkov, adaptéry na strane servera Queue-Fair bežia na vašom webovom serveri.To znamená, že vaše servery môžu návštevníkov posielať do frontu efektívnejšie. Zlí aktéri neuvidia obsah vášho webu, avšak boti môžu stále zadávať požiadavky na vaše servery, takže pre úplnú ochranu pred DDoS použite jeden z našich sieťových adaptérov nižšie.
Adaptéry webového servera
To znamená, že váš webový server môže využívať ďalšie bezpečnostné funkcie na odmietnutie prístupu osobám, ktoré neboli zaradené do fronty. Znamená to tiež, že váš webový server sa vyhne záťaži pri generovaní a zobrazovaní stránok obsahujúcich skript Adapter.
Pridanie knižníc Queue-Fair Server-Side Adapter trvá len niekoľko minút s minimálnymi zmenami kódu na aktiváciu a spustenie Adaptéra.
Väčšina našich zákazníkov začína s adaptérom JavaScript na strane klienta a na adaptér na strane servera prechádza len v prípade špecifickej funkčnosti alebo obchodnej potreby.
Jednoduchý a bezpečný režim
Adaptéry na strane servera Queue-Fair môžu pracovať v jednoduchom alebo bezpečnom režime.
V jednoduchom režime sú všetci návštevníci odoslaní na servery Queue-Fair, aby sa spočítali bez ohľadu na to, či sa vytvorila fronta. Ak je vytvorený front, zaradia sa do neho. Keď nie je vytvorená žiadna fronta, sú vrátení na váš webový server ihneď, bez zobrazenia stránky fronty - ale s podpisom, ktorý váš webový server potrebuje na zabezpečenie toho, aby k vašim chráneným zdrojom mali prístup len ľudia, ktorí prešli frontu.
V bezpečnom režime sa návštevníci odosielajú na servery Queue-Fair len vtedy, keď je vytvorená fronta. Váš webový server priamo konzultuje naše servery fronty na pozadí, aby toto určenie vykonal. Návštevníci sú stále bezpečne digitálne podpísaní bez ohľadu na to, či sa zaradia do fronty, alebo či sú prepustení bez zobrazenia stránky fronty, pretože fronta je prázdna.
Bezpečný režim sa odporúča pre každodenné fronty. Jednoduchý režim je vhodný pre časovo obmedzené udalosti alebo predaj, keď očakávate tisíce ľudí, pretože eliminuje oneskorenie spôsobené kontrolným volaním z vášho webového servera na naše servery fronty, čo znamená, že môžete efektívnejšie posielať ľudí, aby sa pripojili do fronty.
Úložiská GitHub
Dynamické stránky frontu
Rovnako ako v prípade adaptéra na strane klienta, všetky údaje, ktoré chcete, môžete odovzdať z vášho webového servera na naše servery a na stránky fronty, ktoré vidia vaši návštevníci, odovzdaním týchto informácií vo volaní adaptéra na strane servera, keď sa ľudia pripájajú do fronty. To uľahčuje dynamické prispôsobenie stránky fronty alebo iné prispôsobenie za chodu rovnakým spôsobom - všetky funkcie adaptéra na strane klienta sú plne podporované. Ak chcete na svojom účte povoliť funkciu Dynamické stránky fronty, obráťte sa na podporu.
Adaptér na strane servera Ďalšie zdroje
Naše adaptéry na strane servera sú podrobne opísané v technickej príručke. Technická príručka je k dispozícii na portáli Queue-Fair > v časti Pomocník alebo si môžete vyžiadať jej kópiu od nás. Ďalšie informácie o každom z adaptérov nájdete aj v súbore README.md každého globálneho komunitného úložiska GitHub.
Sieťové adaptéry
Sieťové adaptéry Queue-Fair bežia v rámci vašej siete CDN alebo poskytovateľa cloudových služieb, a nie v prehliadačoch návštevníkov alebo na vašom pôvodnom serveri. Toto je najlepší spôsob, ako používať Queue-Fair na ochranu serverov pred útokmi botov vrátane útokov DDoS.
Adaptéry poskytovateľa Lambda a CDN
Poskytuje rovnaké funkcie a zabezpečenie ako adaptér na strane servera a rovnakú ochranu proti zaťaženiu ako priame prepojenie.
Pridanie knižníc sieťového adaptéra Queue-Fair Network-Edge Adapter trvá len niekoľko minút s minimálnymi zmenami kódu u poskytovateľa cloudu na aktiváciu a spustenie adaptéra, ktorý je zvyčajne nasadený ako funkcia Lambda alebo Edge Worker.
Jednoduchý a bezpečný režim
Rovnako ako naše adaptéry na strane servera môžu naše sieťové adaptéry pracovať v jednoduchom alebo bezpečnom režime.
Dostupné adaptéry
Dynamické stránky frontu
Rovnako ako v prípade adaptéra na strane klienta, akékoľvek údaje, ktoré si želáte, môžete odovzdať z vášho webu na naše servery a na stránky frontu, ktoré vidia vaši návštevníci, odovzdaním týchto informácií vo volaní adaptéra. To uľahčuje dynamické prispôsobenie stránky fronty alebo iné prispôsobenie za chodu, pretože ľudia sa do fronty pripájajú rovnakým spôsobom - všetky funkcie adaptéra na strane klienta sú plne podporované. Ak chcete na svojom účte povoliť dynamické stránky fronty, obráťte sa na podporu.
Sieťový adaptér Ďalšie zdroje
Naše sieťové adaptéry sú podrobne opísané v technickej príručke. Technická príručka je k dispozícii na portáli Queue-Fair > v časti Pomocník alebo si môžete vyžiadať jej kópiu od nás. Ďalšie informácie o každom z adaptérov nájdete aj v súbore README.md každého globálneho úložiska komunity GitHub.
Rozhrania API REST
Queue-Fair poskytuje vývojárom prístup k šiestim modulom REST API. Na používanie rozhrania API budete potrebovať účet Queue-Fair. Ak chcete povoliť prístup k API pre svoje konto, obráťte sa na podporu Queue-Fair. Naše moduly REST API sú v súlade so štandardmi OpenAPI, RFC 7807 a RFC 3339.
Náš balík modulov API je komplexný - všetko, čo môžete robiť na portáli, môžete robiť aj pomocou API, okrem správy používateľov portálu, ktorá je vylúčená z dôvodu ochrany osobných údajov.
Každý modul API je plne zdokumentovaný na stránke api.queue-fair.net, kde nájdete aj rozhranie Swagger na jednoduché používanie a testovanie. Z dôvodu bezpečnosti sú všetky volania API chránené bezpečným šifrovaním TLS a vyžadujú si kľúč API, ktorý je špecifický pre váš účet.
Moduly API
Dynamické stránky frontu
Svoje stránky fronty môžete upravovať aj za behu bez toho, aby ste museli aktualizovať databázu pomocou rozhrania API portálu alebo prezentácie - pre ďalšie podrobnosti a povolenie dynamických stránok fronty vo svojom konte kontaktujte podporu.
REST API Ďalšie zdroje
V súlade s požiadavkami RFC 7807 nájdete dokumentáciu o chybových hláseniach, ktoré môžu byť vrátené našimi modulmi REST API, na adrese queue-fair.com/api-error
Natívne aplikácie
Queue-Fair vyzerá skvele v mobilných prehliadačoch, ako aj na stolových počítačoch a notebookoch.
Queue-Fair môžete používať aj priamo vo svojich natívnych aplikáciách pre iOS a Android a tiež v aplikáciách React Native v systémoch iOS, Android, Windows a MacOS na ochranu činností alebo operácií náročných na zdroje.
Adaptéry aplikácií Queue-Fair využívajú webového klienta na pripojenie aplikácií a zobrazenie vlastných zobrazení fronty pre vašich používateľov, keď sú vaše služby príliš obsadené, s flexibilitou a jednoduchosťou používania Queue-Fair Portal.
Používateľov môžete zaradiť do rovnakého frontu ako návštevníkov webovej lokality alebo môžete vytvoriť samostatný front pre používateľov aplikácie - je to na vás.
Rovnako ako pri našich webových frontoch sa miesto každého používateľa po jeho zaradení do frontu automaticky uloží aj v prípade, že odíde z aplikácie.
Úložiská GitHub
Upozornenia na fronty
Adaptér Queue-Fair má spätné volania, ktoré uľahčujú odosielanie oznámení Push používateľom, ktorí nepoužívajú vašu aplikáciu alebo frontu, keď na nich príde rad. Miesto používateľa vo fronte je automaticky trvalo uložené adaptérom vo vašej aplikácii. Ak používateľ odíde z vašej aplikácie, vaša aplikácia oznámi vášmu serveru Push Notification, že sa má odoslať oznámenie, pričom uloženú informáciu o pozícii vo fronte odošle ako súčasť tejto správy vášmu serveru Push Notification.
Ide o rovnakú technológiu, akú používame v našej spotrebiteľskej aplikácii a službe WeQ4U, ktorú si len v Spojenom kráľovstve stiahlo približne 2 milióny používateľov.
Váš server Push Notification pravidelne konzultuje rozhranie Queue-Fair Status API, aby zistil aktuálne obslúženú pozíciu vo fronte. Keď je táto hodnota väčšia ako pozícia vo fronte konkrétneho používateľa, je čas kontaktovať tohto používateľa s oznámením. Ak sa používateľ vráti do frontu alebo je Passed pred odoslaním oznámenia Push Notification, spätné volania v adaptéri upozornia vašu aplikáciu a vaša aplikácia oznámi serveru Push Notification, že oznámenie už nie je potrebné.
Podľa našich informácií sme jediným poskytovateľom virtuálnej čakárne, ktorý túto funkciu podporuje.
Video zdroje
Tu je video s natívnym adaptérom aplikácie v akcii, ktoré ukazuje, že miesto používateľa je uložené aj v prípade, že je aplikácia úplne zastavená, a tiež ukazuje háčiky adaptéra, ktoré vaša aplikácia používa na odosielanie oznámení Push.
Ďalšie zdroje
Naše natívne adaptéry aplikácií sú opísané v technickej príručke. Technická príručka je k dispozícii na portáli Queue-Fair > v časti Pomocník alebo si môžete vyžiadať jej kópiu od nás. Ďalšie informácie o každom z adaptérov, ktoré sú špecifické pre systémy iOS a Android, nájdete aj v súbore README.md každého globálneho repozitára komunity GitHub.
Adaptéry ECommerce
Queue-Fair možno jednoducho pridať do akéhokoľvek systému elektronického obchodovania pomocou vyššie opísaného adaptéra JavaScript na strane klienta.
Ponúkame aj kód adaptéra na prácu na strane servera s mnohými populárnymi servermi elektronického obchodu.
Úložiská GitHub
Ďalšie zdroje
Naše adaptéry sú opísané v technickej príručke. Technická príručka je k dispozícii na portáli Queue-Fair > v časti Pomocník alebo si môžete vyžiadať jej kópiu od nás.
Máme k dispozícii aj doplnkové príručky pre väčšinu platforiem elektronického obchodu - stačí požiadať o tú, ktorú chcete.
Hybridné zabezpečenie
Flexibilitu adaptéra JavaScript na strane klienta môžete ľahko kombinovať s dodatočnou vrstvou zabezpečenia, ktorú poskytuje náš kód na strane servera.
Spoločnosť Queue-Fair označí každého návštevníka, ktorého prejdeme, digitálnym odtlačkom prsta, ktorý je pre daného návštevníka jedinečný. Jedinečne v tomto odvetví podpis obsahuje aj kód špecifický pre prehliadač návštevníka, aby sa zabránilo zdieľaniu prístupových tokenov.
Váš webový server môže overiť podpis pomocou tajomstva, ktoré poznáte len vy a my - nie vaši návštevníci - aby sa zabezpečilo, že každý návštevník prešiel servermi Queue-Fair spravodlivo.
Takže môžete použiť adaptér JavaScript na strane klienta na odosielanie a prijímanie návštevníkov do a z fronty a kontrolovať, či nedošlo k manipulácii pred ich objednaním s minimálnym kódom na strane servera, a vyhnúť sa zavedeniu závislosti na našom systéme.
V našich globálnych komunitných repozitároch GitHub je zahrnutý vzorový kód v každom hlavnom webovom programovacom jazyku.
Úložiská GitHub
Ďalšie zdroje
Hybridný bezpečnostný model je podrobne opísaný v Technickej príručke. Technická príručka je k dispozícii na portáli Queue-Fair > v časti Pomocník alebo si môžete vyžiadať jej kópiu od nás.
Licencia
Náš zverejnený kód dostupný v repozitári GitHub Queue-Fair je licencovaný pod licenciou MIT, ktorá patrí medzi najprísnejšie licencie otvoreného softvéru pre globálnu komunitu.
Chcete vedieť, ako funguje Queue-Fair?
2024 The Fair Queue People Ltd. - Všetky práva vyhradené.
Súčasť rodiny riešení Orderly pre fronty - OrderlyQ - OrderlyStats - WeQ4U