Viri za razvijalce

Upravitelj oznak Google

Repozitorij GitHub za virtualno čakalnico Queue-Fair Google Tag Manager Client-Side Adapter Tag.

Dinamične strani čakalne vrste

Vse podatke, ki jih želite, lahko z vašega spletnega mesta posredujete našemu sistemu čakanja v čakalno vrsto in stranem čakalne vrste, ki jih vidijo vaši obiskovalci, z uporabo atributa data-queue-fair-extra, ki je na voljo v oznaki JavaScript na strani odjemalca in izvedbi Google Tag Manager. Če želite v svojem računu omogočiti dinamične strani čakalnih vrst, se obrnite na podporo uporab nikom.

To funkcijo lahko uporabite za sprotno prilagajanje strani čakalne vrste. Queue-Fair lahko uporabite tudi za posredovanje podatkov, ki nam jih pošljete skupaj z obiskovalci, nazaj na svoje spletno mesto, ko ti preidejo skozi čakalno vrsto, kar zagotavlja dodatno raven varnosti.

Zagotavljamo tudi vmesnik API za dinamične strani čakalne vrste, ki uporablja dodatne podatke za prilagajanje katerega koli vidika strani čakalne vrste, tako da lahko ustvarite eno čakalno vrsto za celotno spletno mesto in jo samodejno prilagodite za različne dogodke ali izdelke na spletnem mestu, ne da bi morali na portalu Queue-Fair

Shopify, WooCommerce & Wordpress upravljanje čakalnih vrst

Če uporabljate spletno mesto, ki temelji na programu Wordpress, kot je sistem nakupovalne košarice WooCommerce, lahko preprosto dodate oznako Client-Side JavasScript Adapter z uporabo vtičnika Wordpress Insert Headers & Footers Plugin, ne da bi morali spremeniti katero koli temo ali predlogo ali se dotakniti kode programa Wordpress.

Prenesite vtičnik Insert Headers & Footers, ga razpakirajte v mapo /wp-content/plugins/, aktivirajte vtičnik v meniju Plugins, odprite vtičnik v meniju Settings, dodajte oznako v Scripts in Header, kot je prikazano, kliknite Save na dnu strani in končali ste! Enostavno upravljanje čakalnih vrst Wordpress. Za dodajanje oznake lahko uporabite tudi druge vtičnike Wordpress - ta je najbolj priljubljen.

Nekatere stranke Wordpressa želijo dodati oznako Queue-Fair JavaScript tudi na svoje strani z napakami Wordpressa, kar lahko storite z urejanjem datoteke /wp-includes/functions.php - dodajte jo v HTML, ki ga vsebuje funkcija _default_wp_die_handler v tej datoteki.

Storitev Shopify je prav tako preprosta - tukaj so navodila za dodajanje adapterja Queue-Fair Client-Side JavaScript v trgovino Shopify - uporabite tri pike zgoraj levo po pritisku na gumb Prilagodi za urejanje kode v datoteki theme.liquid Layout.

Virtualna čakalnica SquareSpace na strani stranke

Pripomoček JavaScript na strani odjemalca je zelo enostavno dodati tudi na spletno mesto SquareSpace - prijavite se in izberite svoje spletno mesto, nato Spletno mesto v levem navigacijskem oknu, Orodja za spletno mesto (v razdelku Pripomočki v levem navigacijskem oknu), Vbrizgavanje kode, nato pa ga kopirajte in prilepite v polje Header in nato Shrani v zgornjem levem kotu.

Za največjo varnost v prostoru SquareSpace uporabite naš adapter SquareSpace Network-Edge Adapter, ki je opisan spodaj.

Adapter na strani odjemalca Dodatna sredstva

Adapter na strani odjemalca je v celoti opisan v tehničnem priročniku. Tehnični vodnik je na voljo na portalu Queue-Fair > v razdelku Pomoč, lahko pa od nas zahtevate kopijo.

Medtem ko se adapter na strani odjemalca izvaja v brskalnikih obiskovalcev v jeziku JavaScript, se adapterji na strani strežnika Queue-Fair izvajajo v vašem spletnem strežniku.To pomeni, da lahko vaši strežniki obiskovalce učinkoviteje pošiljajo v čakalno vrsto. Zlobni akterji ne bodo videli vsebine z vašega spletnega mesta, vendar bodo roboti še vedno lahko pošiljali zahtevke na vaše strežnike, zato za popolno zaščito pred napadi DDoS uporabite enega od naših adapterjev na robu omrežja spodaj.

Priključki za spletni strežnik

To pomeni, da lahko spletni strežnik izkoristi dodatne varnostne funkcije in onemogoči dostop osebam, ki niso bile uvrščene v čakalno vrsto. To pomeni tudi, da se spletni strežnik izogne obremenitvi zaradi ustvarjanja in prikazovanja strani, ki vsebujejo skripto Adapter.

Dodajanje knjižnic adapterja na strani strežnika Queue-Fair traja le nekaj minut z minimalnimi spremembami kode za aktiviranje in zagon adapterja.

Večina naših strank začne z adapterjem JavaScript na strani odjemalca in preide na adapter na strani strežnika le, če obstaja posebna funkcionalnost ali poslovna potreba.

Preprost in varen način

Strežniški adapterji Queue-Fair lahko delujejo v preprostem ali varnem načinu.

V preprostem načinu se vsi obiskovalci pošljejo strežnikom Queue-Fair, da se preštejejo, ne glede na to, ali je bila oblikovana čakalna vrsta ali ne. Če je čakalna vrsta oblikovana, se ji pridružijo. Če čakalne vrste ni, so takoj vrnjeni v spletni strežnik, ne da bi videli stran čakalne vrste - vendar s podpisom, ki ga spletni strežnik potrebuje za zagotovitev, da lahko do vaših zaščitenih virov dostopajo samo osebe, ki so bile v čakalni vrsti izpuščene.

V varnem načinu se obiskovalci pošljejo v strežnike Queue-Fair samo, če je na voljo čakalna vrsta. Vaš spletni strežnik se pri tem neposredno posvetuje z našimi strežniki čakalnih vrst v ozadju. Obiskovalci so še vedno varno digitalno podpisani, ne glede na to, ali se pridružijo čakalni vrsti ali pa so prepuščeni, ne da bi videli stran čakalne vrste, ker je čakalna vrsta prazna.

Varni način je priporočljiv za vsakodnevne čakalne vrste. Enostavni način je primeren za časovno omejene dogodke ali prodajo, ko pričakujete na tisoče ljudi, saj odpravlja zakasnitve zaradi preverjanja klicev iz vašega spletnega strežnika v naše strežnike čakalnih vrst, kar pomeni, da lahko ljudi učinkoviteje pošljete v čakalno vrsto.

Repozitoriji GitHub

PHP

Repozitorij GitHub za adapter Queue-Fair Virtual Waiting Room na strani strežnika v PHP.

Java

Skladišče GitHub za adapter Queue-Fair Virtual Waiting Room na strani strežnika za Javo, vključno z JBossom in Tomcatom.

Ruby

Repozitorij GitHub za adapter Queue-Fair Virtual Waiting Room na strani strežnika v jeziku Ruby in (po želji) Rails

Python

Repozitorij GitHub za strežniški adapter virtualne čakalnice Queue-Fair v Pythonu in (po želji) Djangu.

.NET

Repozitorij GitHub za adapter Queue-Fair Virtual Waiting Room na strani strežnika za .NET, ASP in C#.

Node.js

Repozitorij GitHub za adapter Queue-Fair Virtual Waiting Room na strani strežnika za Node.js in (po želji) Express.

Dinamične strani čakalne vrste

Tako kot pri adapterju na strani odjemalca lahko vse podatke, ki jih želite, posredujete iz spletnega strežnika našim strežnikom in stranem čakalne vrste, ki jih vidijo obiskovalci, tako da te informacije posredujete v klicu adapterja na strani strežnika, ko se ljudje pridružijo čakalni vrsti. To na enak način omogoča dinamično stran čakalne vrste ali druge prilagoditve na kraju samem - vse funkcije adapterja na strani odjemalca so v celoti podprte. Če želite v svojem računu omogočiti dinamične strani čakalne vrste, se obrnite na podporo uporab nikom.

Dodatni viri adapterja na strani strežnika

Naši adapterji na strani strežnika so v celoti opisani v tehničnem priročniku. Tehnični vodnik je na voljo na portalu Queue-Fair > v razdelku Pomoč, lahko pa od nas zahtevate kopijo. Več informacij o vsakem od adapterjev lahko najdete tudi v README.md vsakega globalnega repozitorija skupnosti GitHub.

Priključki Queue-Fair Network-Edge Adapters delujejo v okviru vašega ponudnika CDN ali storitev v oblaku in ne v brskalnikih obiskovalcev ali v vašem izvornem strežniku. To je najboljši način uporabe Queue-Fair za zaščito strežnikov pred napadi botov, vključno z napadi DDoS.

Priključki ponudnikov Lambda in CDN

To zagotavlja enako funkcionalnost in varnost kot adapter na strani strežnika ter enako zaščito pred obremenitvijo kot neposredna povezava.

Dodajanje knjižnic Queue-Fair Network-Edge Adapter traja le nekaj minut z minimalnimi spremembami kode pri ponudniku storitev v oblaku, da se adapter aktivira in zažene, kar se običajno izvede kot funkcija Lambda ali Edge Worker.

Preprost in varen način

Tako kot naši strežniški adapterji lahko tudi omrežni adapterji delujejo v preprostem ali varnem načinu.

Razpoložljivi adapterji

Cloudfront

Adapter za virtualno čakalnico Amazon AWS CloudFront Network-Edge.

Cloudflare

Adapter virtualne čakalnice v omrežju Cloudflare

Fastly

Hitro omrežni adapter za virtualno čakalnico.

Akamai

Akamai Network-Edge Virtual Waiting Room Adapter.

Azure

Adapter za virtualno čakalnico na ravni omrežja Azure.

Google Cloud

Adapter za virtualno čakalnico na ravni Googlovega omrežja v oblaku.

Dinamične strani čakalne vrste

Tako kot pri adapterju na strani odjemalca lahko tudi pri adapterju na strani odjemalca vse podatke, ki jih želite, posredujete z vašega spletnega mesta našim strežnikom in stranem čakalne vrste, ki jih vidijo vaši obiskovalci, tako da te podatke posredujete v klicu adapterja. To omogoča dinamično stran čakalne vrste ali drugo prilagajanje sproti, saj se ljudje pridružujejo čakalni vrsti na enak način - vse funkcije adapterja na strani odjemalca so v celoti podprte. Če želite v svojem računu omogočiti dinamične strani čakalne vrste, se obrnite na podporo uporab nikom.

Adapter na robu omrežja Dodatna sredstva

Naši omrežni adapterji so v celoti opisani v tehničnem priročniku. Tehnični vodnik je na voljo na portalu Queue-Fair > v razdelku Pomoč, lahko pa od nas zahtevate kopijo. Več informacij o vsakem od adapterjev lahko najdete tudi v README.md vsakega od globalnih repozitorijev skupnosti GitHub.

Queue-Fair razvijalcem omogoča dostop do šestih modulov API REST. Za uporabo API-ja potrebujete račun Queue-Fair. Če želite omogočiti dostop do API za svoj račun, se obrnite na podporo Queue-Fair. Naši moduli API REST so skladni s standardi OpenAPI, RFC 7807 in RFC 3339.

Naš nabor modulov API je obsežen - vse, kar lahko naredite v portalu, lahko naredite tudi z vmesnikom API, razen upravljanja uporabnikov portala, ki je izključeno zaradi varovanja zasebnosti.

Vsak modul API je v celoti dokumentiran na spletni strani api.queue-fair.net, kjer najdete tudi vmesnik Swagger za lažjo uporabo in testiranje. Zaradi varnosti so vsi klici API zaščiteni z varnim šifriranjem TLS in zahtevajo ključ API, ki je specifičen za vaš račun.

Moduli API

Dinamične strani čakalne vrste

Strani čakalnih vrst lahko spreminjate tudi sproti, ne da bi vam bilo treba posodabljati podatkovno zbirko z uporabo portala ali vmesnika API za predstavitve - za več podrobnosti in omogočanje dinamičnih strani čakalnih vrst v svojem računu se obrnite na podporo uporab nikom.

Dodatni viri API REST

V skladu z zahtevami standarda RFC 7807 lahko dokumentacijo o sporočilih o napakah, ki jih lahko vrnejo naši moduli API REST, najdete na naslovu queue-fair.com/api-error.

Queue-Fair je videti odlično v mobilnih brskalnikih ter namiznih in prenosnih računalnikih.

Queue-Fair lahko za zaščito dejavnosti ali operacij, ki zahtevajo veliko virov, uporabljate tudi neposredno v izvirnih aplikacijah za iOS in Android ter aplikacijah React Native v operacijskih sistemih iOS, Android, Windows in MacOS.

Priključki za aplikacije Queue-Fair uporabljajo WebClient za povezovanje aplikacij in prikaz po meri uporabnikom, ko so storitve preveč zasedene, s prilagodljivostjo in preprostostjo uporabe Queue-Fair Portal.

Uporabnike lahko postavite v isto vrsto kot obiskovalce spletnega mesta ali pa za uporabnike aplikacij ustvarite ločeno vrsto - vse je odvisno od vas.

Tako kot pri naših spletnih čakalnih vrstah se mesto vsakega uporabnika po vključitvi v čakalno vrsto samodejno shrani, tudi če se oddalji od vaše aplikacije.

Repozitoriji GitHub

iOS & MacOS

Repozitorij GitHub za navidezno čakalnico Queue-Fair za iOS in MacOS.

Android

Repozitorij GitHub za adapter Queue-Fair za virtualno čakalnico za Android.

React Native

Repozitorij GitHub za adapter Queue-Fair Virtual Waiting Room za aplikacije React Native za Android, iOS, MacOS in Windows.

Obvestila o čakalni vrsti

Adapter Queue-Fair ima povratne klice, s katerimi lahko uporabnikom, ki ne uporabljajo vaše aplikacije ali čakalne vrste, enostavno pošljete potisno obvestilo, ko je na vrsti njihov klic. Adapter samodejno trajno shrani uporabnikovo mesto v čakalni vrsti v vaši aplikaciji. Če se uporabnik oddalji od vaše aplikacije, vaša aplikacija sporoči strežniku za obvestila Push, da je treba poslati obvestilo, in kot del sporočila pošlje strežniku za obvestila Push shranjeno informacijo o položaju v čakalni vrsti.

To je ista tehnologija, ki jo uporabljamo za našo aplikacijo in storitev za potrošnike WeQ4U, ki je bila samo v Združenem kraljestvu prenesena v približno 2 milijona različicah.

Vaš strežnik za potisna obvestila se občasno posvetuje z vmesnikom API statusa Queue-Fair, da bi poizvedel po položaju v čakalni vrsti, ki je trenutno na voljo. Ko je ta večji od položaja v čakalni vrsti določenega uporabnika, je čas, da z obvestilom stopite v stik s tem uporabnikom. Če se uporabnik vrne v čakalno vrsto ali je prepuščen, preden je bilo poslano obvestilo Push, povratni klici v adapterju obvestijo vašo aplikacijo, vaša aplikacija pa sporoči strežniku Push Notification, da obvestilo ni več potrebno.

Po našem vedenju smo edini ponudnik virtualne čakalnice, ki podpira to funkcijo.

Video viri

V videoposnetku je prikazan adapter za nativno aplikacijo, ki prikazuje, da se mesto uporabnika shrani, tudi če se aplikacija popolnoma ustavi, in kavlji adapterja, ki jih aplikacija uporablja za pošiljanje potisnih obvestil.

Dodatni viri

Naši nativni aplikacijski adapterji so opisani v tehničnem priročniku. Tehnični vodnik je na voljo na portalu Queue-Fair > v razdelku Pomoč, lahko pa od nas zahtevate kopijo. Več informacij o vsakem od adapterjev, ki so specifični za iOS in Android, lahko najdete tudi v README.md vsakega od repozitorijev globalne skupnosti GitHub.

Queue-Fair je mogoče preprosto dodati kateremu koli sistemu e-trgovine z zgoraj opisanim adapterjem JavaScript na strani odjemalca.

Ponujamo tudi kodo Adapter za delovanje na strani strežnika s številnimi priljubljenimi strežniki za elektronsko poslovanje.

Repozitoriji GitHub

Magento

Repozitorij GitHub za adapter Queue-Fair za virtualno čakalnico za Magento.

WooCommerce

Repozitorij GitHub za Queue-Fair Virtual Waiting Room Adapter za WooCommerce v PHP.

SquareSpace

Repozitorij GitHub za adapter Queue-Fair za virtualno čakalnico za SquareSpace.

PrestaShop

Repozitorij GitHub za Queue-Fair Virtual Waiting Room Adapter za PrestaShop v PHP.

Dodatni viri

Naši adapterji so opisani v tehničnem priročniku. Tehnični vodnik je na voljo na portalu Queue-Fair > v razdelku Pomoč, lahko pa od nas zahtevate kopijo.

Na voljo imamo tudi dodatna navodila za večino platform za e-trgovino - vprašajte za želeno.

Prilagodljivost adapterja JavaScript na strani odjemalca lahko preprosto združite z dodatno varnostno plastjo, ki jo zagotavlja naša koda na strani strežnika.

Queue-Fair vsakega obiskovalca, ki ga posredujemo, označi z digitalnim prstnim odtisom, ki je edinstven za tega obiskovalca. Edinstveno v panogi je, da podpis vključuje tudi kodo, značilno za obiskovalčev brskalnik, da se prepreči deljenje dostopnih žetonov.

Vaš spletni strežnik lahko potrdi podpis z uporabo skrivnosti, ki je znana samo vam in nam - ne pa vašim obiskovalcem - in tako zagotovi, da je bil vsak obiskovalec pošteno posredovan strežnikom Queue-Fair.

Tako lahko z adapterjem JavaScript na strani odjemalca pošiljate in sprejemate obiskovalce v čakalno vrsto in iz nje ter preverjate posege, preden se naročijo, z minimalno kodo na strani strežnika in se izognete uvedbi odvisnosti od našega sistema.

V naših skladiščih globalne skupnosti GitHub so vključeni primeri kode v vseh glavnih spletnih programskih jezikih.

Repozitoriji GitHub

PHP

Repozitorij GitHub za adapter Queue-Fair Virtual Waiting Room na strani strežnika v PHP.

Java

Skladišče GitHub za adapter Queue-Fair Virtual Waiting Room na strani strežnika za Javo, vključno z JBossom in Tomcatom.

Ruby

Repozitorij GitHub za adapter Queue-Fair Virtual Waiting Room na strani strežnika v jeziku Ruby in (po želji) Rails

Python

Repozitorij GitHub za strežniški adapter virtualne čakalnice Queue-Fair v Pythonu in (po želji) Djangu.

.NET

Repozitorij GitHub za adapter Queue-Fair Virtual Waiting Room na strani strežnika za .NET, ASP in C#.

Node.js

Repozitorij GitHub za adapter Queue-Fair Virtual Waiting Room na strani strežnika za Node.js in (po želji) Express.

Dodatni viri

Hibridni varnostni model je v celoti opisan v tehničnem priročniku. Tehnični vodnik je na voljo na portalu Queue-Fair > v razdelku Pomoč, lahko pa od nas zahtevate kopijo.

Naša objavljena koda, ki je na voljo v repozitoriju GitHub Queue-Fair, je licencirana z licenco MIT, ki je med najbolj dovoljenimi odprtokodnimi licencami za svetovno skupnost.