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 storitve Queue-Fair z obstoječim sistemom lahko najdete v tehničnem vodniku 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.

Najhitrejši način, da začnete s Queue-Fair, je, da se prijavite na Brezplačni nivo račun - to lahko storite zdaj prek spleta in takoj začnete z integracijo in testiranjem.

Potrebujete pomoč pri nastavljanju stopenj za čakalno vrsto? Vse, kar morate vedeti, je tukaj.

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.

Naš adapter JavaScript na strani odjemalca je bolj varen kot deli integracije na strani odjemalca drugih ponudnikov. Ker deluje v brskalnikih vaših obiskovalcev, lahko tehnično spretni obiskovalci posegajo v 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. V nasprotju z deli za integracijo na strani odjemalca drugih ponudnikov ga je mogoče narediti odpornega na posege s hibridnim varnostnim modelom, opisanim v tehničnem priročniku.

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.:

globalna skupnost izključuje davek razvrstitev izpopolniti ceno čakalne vrste za WordPress vtičniki

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 sistema za čakanje v vrsti za te obiskovalce.

WordPress vtičniki wp cron odlično orodje za iskanje wordpress in objave skupnosti na mestu po odlični ceni

Repozitoriji GitHub

Wordpress naloge plugin lastnost ustvariti podatke dolarjev ni potrebno php

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

kakor koli spreminjati strani čakalne vrste.



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.

blagovne znamke se pridružijo predlogam za nadzor povratnega klica v ozadju na točki

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.


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



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.


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



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.


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



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.

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

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.


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

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

Repozitoriji GitHub

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 dovoljenimi odprtokodnimi licencami za svetovno skupnost.


Želite vedeti, kako deluje Queue-Fair?