Viri za razvijalce



Dodajanje Queue-Fair

Virtualno čakalnico Queue-Fair lahko v nekaj minutah preprosto dodate na različne spletne platforme in aplikacije. Uporabite enega od naših adapterjev. Več informacij o najboljšem načinu integracije Queue-Fair z obstoječim sistemom najdete v tehničnem priročniku ali v razdelku Portal Queue-Fair > Pomoč. Če iščete informacije o tem, kako preprečiti botom ali ljudem, da bi oddali več naročil, ali kako zaščititi prodajo NFT pred previsokimi pristojbinami za plin, si lahko preberete ta pregled ali si ogledate vse podrobnosti v razdelku Varnostni vodnik na portalu.

Adapter na strani odjemalca

Za spletna mesta je najpreprostejši način za integracijo s Queue-Fair dodajanje oznake JavaScript Client-Side Queue-Fair Adapter na svoje strani. Adapter lahko varno dodate na vse strani na svojem spletnem mestu in z aktivacijskimi pravili na portalu Queue-Fair določite, na katerih straneh se lahko vrže čakalna vrsta.

Ker deluje v brskalnikih obiskovalcev, lahko tehnično spretni obiskovalci onemogočijo adapter na strani odjemalca, vendar je zelo učinkovit pri preprečevanju preobremenitve, saj bo le zelo majhna manjšina ljudi poskušala preskočiti čakalno vrsto s poseganjem v JavaScript. Večina naših strank uporablja Client-Side Adapter, ker je učinkovit pri preprečevanju sesutja spletnega mesta, enostaven za namestitev in ne uvaja nobene odvisnosti med našim in vašim sistemom.

Varnostno plast lahko dodate tako, da oznako JavaScript nadomestite z adapterjem na strani strežnika ali pa združite prilagodljivost adapterja JavaScript s hibridnim varnostnim modelom, opisanim na tej strani; oba načina sta varna.

Ena vrstica kode

Če želite na svoje spletno mesto dodati adapter na strani odjemalca, dodajte naslednjo eno vrstico kode v <head> v razdelku vaših strani.:

Dodajte našo virtualno čakalnico na svoje spletno mesto s to eno vrstico kode in preprečite sesutje spletnega mesta.

Nekatere stranke dodajo besedo defer ki povzroči, da se skript Adapter prenese vzporedno z razčlenjevanjem strani in da se začne izvajati v brskalniku obiskovalca šele, ko je razčlenjevanje strani končano (torej običajno po končanju vseh drugih skript na strani).

Če dodate besedo defer, lahko v nekaterih primerih za majhen delček sekunde izboljšate čas do prve slike, vendar če se odločite za to, bo to pomenilo, da bodo obiskovalci, ki bi morali biti uvrščeni v čakalno vrsto, videli vašo zaščiteno stran delček sekunde dlje, preden bodo poslani v čakalno vrsto.

Upravitelj oznak Google

Zagotavljamo tudi oznako adapterja JavaScript prek upravitelja Google Tag Manager. Queue-Fair poiščite v galeriji skupnostnih predlog v razdelku Dodaj oznako. Upoštevajte, da nekateri blokatorji oglasov preprečujejo prenos glavnega gtm.js od Googla, kar blokira vse operacije programa Google Tag Manager, vključno z zagonom adapterja za te obiskovalce.Naša značka Virtualna čakalnica za Google Tag Manager

Repozitoriji GitHub

Upravitelj oznak Google

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 posredujete z vašega spletnega mesta našim strežnikom 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 čakalne vrste, 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

kakor koli spreminjati strani čakalne vrste.



Shopify, Wordpress in WooCommerce

Č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 vam bilo treba spremeniti katero koli temo 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!

Storitev Shopify je prav tako preprosta - tukaj so navodila za dodajanje adapterja Queue-Fair JavaScript na strani odjemalca v trgovino Shopify.

Nadzorna plošča portala Queue-Fair

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.


Priključki na strani strežnika

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.

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 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 čakalne vrste ni, se obiskovalci takoj vrnejo 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. Obiskovalci so še vedno varno digitalno podpisani, ne glede na to, ali je prikazana stran čakalne vrste ali ne.

Varni način je priporočljiv za vsakodnevne čakalne vrste. Enostavni način je primeren za časovno omejene dogodke, ko pričakujete več tisoč 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 v čakalno vrsto pošiljate učinkoviteje.

Repozitoriji GitHub

Adapter za virtualno čakalnico PHP') ?>

PHP

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

Adapter za virtualno čakalnico Java

Java

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

Adapter za virtualno čakalnico Ruby

Ruby

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

Python Virtual Waiting Room Adapter

Python

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

DotNet Virtual Waiting Room Adapter

.NET

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

Node.js & JavaScript Virtual Waiting Room Adapter

Node.js & JavaScript

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 tudi pri adapterju na strani strežnika vse podatke, ki jih želite, posredujete z vašega spletnega strežnika našim strežnikom in stranem čakalne vrste, ki jih vidijo vaši obiskovalci, tako da te podatke posredujete v klicu adapterja na strani strežnika. To na enak način omogoča dinamično stran čakalne vrste ali drugo prilagajanje v trenutku - vse funkcije adapterja na strani odjemalca so v celoti podprte. Če želite v svojem računu omogočiti dinamične strani čakalnih vrst, se obrnite na podporo za podporo uporabnikom.

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 repozitorija GitHub.


Adapterji na robu omrežja

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.

Priključki ponudnikov Lambda in CDN

To zagotavlja enako varnost kot adapter na strani strežnika in 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

Adapter za virtualno čakalnico Amazon AWS CloudFront Network-Edge') ?>

CloudFront

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

Adapter virtualne čakalnice v omrežju Cloudflare

Cloudflare

Adapter virtualne čakalnice v omrežju Cloudflare

Hitro omrežni adapter za virtualno čakalnico

Fastly

Hitro omrežni adapter za virtualno čakalnico..

Adapter virtualne čakalnice Akamai Network-Edge

Akamai

Akamai Network-Edge Virtual Waiting Room Adapter.



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 na enak način omogoča dinamično stran čakalne vrste ali drugo sprotno prilagajanje - 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 za podporo uporabnikom.

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 repozitorija GitHub.


API-ji REST

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

API za poročanje

Za poročila v živo, poročila v realnem času, pretekla poročila in zbirne statistike o čakalnih vrstah.

API za upravljanje čakalnih vrst

Za programsko ustvarjanje in spreminjanje čakalnih vrst v realnem času.

API za upravljanje računov

Za pregledovanje in posodabljanje nastavitev celotnega računa.

API za upravljanje sredstev

Za upravljanje sredstev, ki jih uporabljajo strani v čakalni vrsti, ki jih zagotavlja Google CDN.

API za predstavitve

Za spreminjanje vseh vidikov HTML strani čakalne vrste ter sprotno posodabljanje in ustvarjanje različic.

API za aktivacijo

Za konfiguriranje aktivacijskih pravil, ki določajo, katere strani na spletnem mestu lahko sprožijo čakalno vrsto in katera stran se prikaže.



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.


Nativne aplikacije

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.

Aplikacijski adapterji Queue-Fair s pomočjo spletnega odjemalca uporabnikom prikažejo prikaze čakalnih vrst po meri, kadar 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 samodejno shrani tudi, če odide iz aplikacije.

Repozitoriji GitHub

Adapter za virtualno čakalnico iOS, MacOS in Apple

iOS & MacOS

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

Adapter za virtualno čakalnico za Android

Android

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

React Native App Virtual Waiting Room Adapter

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

Z adapterjem Queue-Fair lahko uporabnikom, ki ne uporabljajo vaše aplikacije ali čakalne vrste, preprosto pošljete potisno obvestilo, ko so na vrsti. 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 aplikacijo 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 poizveduje 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 temu uporabniku pošljete obvestilo. Če se uporabnik vrne v čakalno vrsto ali je prepuščen, preden je bilo poslano obvestilo Push, adapter obvesti vašo aplikacijo, vaša aplikacija pa sporoči strežniku za obvestila Push, 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 repozitorija GitHub.


Priključki za elektronsko poslovanje

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 Plugin

Magento

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

WooCommerce/PHP Virtual Waiting Room Adapter

WooCommerce

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

PrestaShop/PHP Virtual Waiting Room Adapter

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.


Hibridna varnost

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 GitHub so vključeni primeri kode v vseh glavnih spletnih programskih jezikih.

Repozitoriji GitHub

PHP

PHP

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

Java

Java

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

Ruby

Ruby

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

Python

Python

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

.NET

.NET

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

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

Node.js & JavaScript

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.


Licenca

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


Želite vedeti, kako deluje Queue-Fair?