Izstrādātāju resursi



Queue-Fair pievienošana

Queue-Fair virtuālo uzgaidāmo telpu var viegli pievienot dažādām tīmekļa un lietotņu platformām dažu minūšu laikā. Vienkārši izmantojiet kādu no mūsu adapteriem. Plašāku informāciju par labāko veidu, kā integrēt Queue-Fair ar esošo sistēmu, varat atrast tehniskajā rokasgrāmatā vai Queue-Fair portāla > palīdzības sadaļā. Ja meklējat informāciju par to, kā apturēt botus vai cilvēkus no vairāku pasūtījumu veikšanas vai kā aizsargāt NFT pārdošanu no pārmērīgas gāzes maksas, varat izlasīt šo pārskatu vai saņemt sīkāku informāciju portāla sadaļā Drošības ceļvedis.

Klienta puses adapteris

Tīmekļa vietnēm visvienkāršākais veids, kā integrēties ar Queue-Fair, ir pievienot savām lapām klienta puses Queue-Fair adaptera JavaScript tagu. Adapteri var droši pievienot visām vietnes lapām un izmantot aktivizēšanas noteikumus Queue-Fair portālā, lai noteiktu, kuras lapas var mest rindu.

Tā kā tas darbojas apmeklētāju pārlūkprogrammās, tehniski prasmīgi apmeklētāji var atspējot klienta puses adapteri, taču tas ļoti efektīvi novērš pārslodzi, jo tikai ļoti neliela daļa cilvēku mēģinās izlaist rindu, manipulējot ar JavaScript. Lielākā daļa mūsu klientu izmanto klienta puses adapteri, jo tas efektīvi novērš vietnes sabrukšanu, ir vienkārši instalējams un neievieš nekādu atkarību starp mūsu un jūsu sistēmu.

Varat pievienot drošības slāni, aizstājot JavaScript tagu ar servera puses adapteri vai kombinēt JavaScript adaptera elastību ar šajā lapā aprakstīto hibrīda drošības modeli; tad abas metodes ir drošas.

Viena koda rinda

Lai pievienotu klienta puses adapteri savai vietnei, vienkārši pievienojiet šādu vienu koda rindiņu. <head> lappušu sadaļu.:

Pievienojiet mūsu virtuālo uzgaidāmo telpu savai vietnei, izmantojot šo vienu koda rindu, un novērsiet vietnes sabrukumus.

Daži klienti pievieno vārdu defer tagam, kas liek adaptera skriptu lejupielādēt paralēli lapas analizēšanai un sākt skripta izpildi apmeklētāja pārlūkprogrammā tikai pēc tam, kad lapa ir pabeigta analizēt (parasti pēc tam, kad ir pabeigti visi citi lapas skripti).

Dažos gadījumos, pievienojot vārdu " atlikt", laiku līdz pirmajai gleznai var uzlabot par nelielu sekundes daļu, taču, ja izvēlaties to darīt, tas nozīmē, ka visi apmeklētāji, kuriem vajadzētu būt rindā, redzēs jūsu aizsargāto lapu par sekundes daļu ilgāk, pirms tie tiks nosūtīti uz rindu.

Google Tag Manager

Mēs piedāvājam arī JavaScript adaptera tagu, izmantojot Google Tag Manager. Meklējiet Queue-Fair Kopienas veidņu galerijā sadaļā Pievienot tagu. Lūdzu, ņemiet vērā, ka daži reklāmu bloķētāji neļauj no Google lejupielādēt galveno gtm.js, kas bloķē visas Google Tag Manager darbības, tostarp adaptera palaišanu šiem apmeklētājiem.Mūsu virtuālās uzgaidāmās telpas birka Google Tag Manager

GitHub repozitoriji

Google Tag Manager

Google Tag Manager

Queue-Fair virtuālās uzgaidāmās telpas Google Tag Manager klienta puses adaptera taga GitHub repozitorijs.

Dinamiskās rindas lapas

No jūsu vietnes uz mūsu serveriem un apmeklētājiem redzamajām rindas lapām var nosūtīt jebkurus datus, izmantojot atribūtu data-queue-fair-extra, kas ir pieejams klienta puses JavaScript tagā un Google Tag Manager implementācijā. Lūdzu, sazinieties ar atbalsta dienestu, ja vēlaties savā kontā iespējot dinamiskās rindas lapas.

Šo funkciju var izmantot, lai pielāgotu rindas lapas. Varat arī izmantot Queue-Fair, lai papildu drošības līmenim nodotu datus, ko mums nosūtāt kopā ar apmeklētājiem, atpakaļ uz savu vietni, kad tie tiek pārsūtīti caur rindu.

Mēs piedāvājam arī dinamiskās rindas lapas API, kas izmanto papildu datus, lai pielāgotu jebkuru rindas lapas aspektu, tādējādi jūs varat izveidot vienu rindu visai vietnei un pielāgot to automātiski dažādiem notikumiem vai produktiem savā vietnē, neveicot nekādas izmaiņas rindas lapās Queue-Fair portālā

.



Shopify, Wordpress un WooCommerce

Ja izmantojat uz Wordpress balstītu vietni, piemēram, WooCommerce iepirkumu grozu sistēmu, varat viegli pievienot klienta puses JavasScript adaptera tagu, izmantojot Wordpress Insert Headers & Footers spraudni, nemainot nevienu no tēmām vai neskarot Wordpress kodu.

Vienkārši lejupielādējiet spraudni Insert Headers & Footers Plugin, atinstalējiet to savā /wp-content/plugins/ mapē, aktivizējiet spraudni spraudņu izvēlnē Plugins, atveriet spraudni no izvēlnes Settings, pievienojiet tagu Scripts in Header, kā parādīts, nospiediet Save lapas apakšā, un viss ir izdarīts!

Shopify ir tikpat vienkārši - šeit ir norādījumi, kā pievienot Queue-Fair klienta puses JavaScript adapteri savam Shopify veikalam.

Queue-Fair portāla informācijas panelis

Klienta puses adapteris Papildu resursi

Klienta puses adapteris ir pilnībā aprakstīts tehniskajā rokasgrāmatā. Tehniskais ceļvedis ir pieejams Queue-Fair portālā > palīdzības sadaļā vai arī varat pieprasītkopiju no mums.


Servera puses adapteri

Ja klienta puses adapteris darbojas jūsu apmeklētāju pārlūkprogrammās, izmantojot JavaScript, tad Queue-Fair servera puses adapteri darbojas jūsu tīmekļa serverī.

Web servera adapteri

Tas nozīmē, ka jūsu tīmekļa serveris var izmantot papildu drošības funkcijas, lai liegtu piekļuvi cilvēkiem, kuri nav iekļauti rindā. Tas nozīmē arī to, ka tīmekļa serveris izvairās no slodzes, kas saistīta ar adaptera skriptu saturošu lapu ģenerēšanu un apkalpošanu.

Queue-Fair servera puses adaptera bibliotēku pievienošana aizņem tikai dažas minūtes ar minimālām izmaiņām kodā, lai aktivizētu un palaistu adapteri.

Lielākā daļa mūsu klientu sāk ar klienta puses JavaScript adapteri un pāriet uz servera puses adapteri tikai tad, ja ir īpaša biznesa nepieciešamība.

Vienkāršs un drošs režīms

Servera puses adapteri Queue-Fair var darboties vienkāršā vai drošā režīmā.

Vienkāršā režīmā visi apmeklētāji tiek nosūtīti uz Queue-Fair serveriem, lai tos saskaitītu, neatkarīgi no tā, vai ir vai nav izveidota rinda. Ja rinda nav izveidota, apmeklētāji tiek uzreiz nosūtīti atpakaļ uz jūsu tīmekļa serveri, neredzot rindas lapu, bet ar parakstu, kas nepieciešams jūsu tīmekļa serverim, lai nodrošinātu, ka tikai tie cilvēki, kuri ir sastādījuši rindu, var piekļūt jūsu aizsargātajiem resursiem.

Drošā režīmā apmeklētāji tiek nosūtīti uz Queue-Fair serveriem tikai tad, ja ir rinda. Lai to noteiktu, jūsu tīmekļa serveris tieši sazinās ar mūsu rindas serveriem. Apmeklētāji joprojām tiek droši digitāli parakstīti neatkarīgi no tā, vai rindas lapa tiek vai netiek rādīta.

Drošais režīms ir ieteicams ikdienas rindām. Vienkāršais režīms ir piemērots laika ziņā ierobežotam pasākumam, kad gaidāmi tūkstošiem cilvēku, jo tas novērš kavēšanos, ko rada pārbaudes izsaukums no jūsu tīmekļa servera uz mūsu rindas serveriem, un tas nozīmē, ka jūs varat efektīvāk nosūtīt cilvēkus uz rindu.

GitHub repozitoriji

PHP virtuālās uzgaidāmās telpas adapteris') ?>

PHP

GitHub repozitorijs Queue-Fair virtuālās uzgaidāmās telpas servera puses adapterim PHP.

Java virtuālās uzgaidāmās telpas adapteris

Java

GitHub repozitorijs Queue-Fair virtuālās uzgaidāmās telpas servera puses adapterim Java, tostarp JBoss un Tomcat.

Rubīna virtuālās uzgaidāmās telpas adapteris

Ruby

GitHub repozitorijs Queue-Fair virtuālās uzgaidāmās telpas servera puses adapterim Ruby un (pēc izvēles) Rails valodā.

Python virtuālās uzgaidāmās telpas adapteris

Python

GitHub repozitorijs Queue-Fair virtuālās uzgaidāmās telpas servera puses adapterim Python un (pēc izvēles) Django.

dotNet virtuālās uzgaidāmās telpas adapteris

.NET

Queue-Fair virtuālās uzgaidāmās telpas servera puses adaptera GitHub repozitorijs .NET, ASP un C#.

Node.js un JavaScript virtuālās uzgaidāmās telpas adapteris

Node.js & JavaScript

Queue-Fair virtuālās uzgaidāmās telpas servera puses adaptera Queue-Fair servera puses adapterim Node.js un (pēc izvēles) Express GitHub repozitorijs.



Dinamiskās rindas lapas

Tāpat kā klienta puses adaptera gadījumā jebkurus vēlamos datus no jūsu tīmekļa servera var pārsūtīt mūsu serveriem un rindas lapām, ko redz jūsu apmeklētāji, pārsūtot šo informāciju servera puses adaptera izsaukumā. Tas atvieglo dinamiskās rindas lapas vai citu pielāgojumu veikšanu uz vietas tādā pašā veidā - visas klienta puses adaptera funkcijas ir pilnībā atbalstītas. Lūdzu, sazinieties ar atbalsta dienestu, ja vēlaties savā kontā iespējot dinamiskās rindas lapas.

Servera puses adapteris Papildu resursi

Mūsu servera puses adapteri ir pilnībā aprakstīti tehniskajā rokasgrāmatā. Tehniskais ceļvedis ir pieejams Queue-Fair portālā > palīdzības sadaļā vai arī varat pieprasītkopiju no mums. Plašāku informāciju par katru no adapteriem var atrast arī katra GitHub repozitorija README.md.


Tīkla malas adapteri

Queue-Fair tīkla malas adapteri darbojas jūsu CDN vai mākoņpakalpojumu sniedzēja sistēmā, nevis apmeklētāju pārlūkprogrammās vai jūsu izcelsmes serverī.

Lambda un CDN nodrošinātāja adapteri

Tas nodrošina tādu pašu drošību kā servera puses adapteris un tādu pašu slodzes aizsardzību kā tiešais savienojums.

Queue-Fair Network-Edge Adapter bibliotēku pievienošana aizņem tikai dažas minūtes ar minimālām koda izmaiņām mākoņpakalpojuma sniedzējā, lai aktivizētu un palaistu adapteri, kas parasti tiek izvietots kā Lambda funkcija vai Edge Worker.

Vienkāršs un drošs režīms

Tāpat kā servera puses adapteri, arī tīkla malas adapteri var darboties vienkāršā vai drošā režīmā.

Pieejamie adapteri

Amazon AWS CloudFront Network-Edge virtuālās uzgaidāmās telpas adapteris') ?>

CloudFront

Amazon AWS CloudFront Network-Edge virtuālās uzgaidāmās telpas adapteris.

Virtuālās uzgaidāmās telpas adapteris Cloudflare Network-Edge

Cloudflare

Virtuālās uzgaidāmās telpas adapteris Cloudflare Network-Edge

Fastly Network-Edge virtuālās uzgaidāmās telpas adapteris

Fastly

Fastly Network-Edge virtuālās uzgaidāmās telpas adapteris..

Akamai Network-Edge virtuālās uzgaidāmās telpas adapteris

Akamai

Akamai Network-Edge virtuālās uzgaidāmās telpas adapteris.



Dinamiskās rindas lapas

Tāpat kā klienta puses adaptera gadījumā jebkurus datus, ko vēlaties, var pārsūtīt no jūsu vietnes uz mūsu serveriem un rindas lapām, ko redz jūsu apmeklētāji, pārsūtot šo informāciju adaptera izsaukumā. Tas atvieglo dinamiskās rindas lapas vai citu pielāgojumu veikšanu uz vietas tādā pašā veidā - visas klienta puses adaptera funkcijas ir pilnībā atbalstītas. Lūdzu, sazinieties ar atbalsta dienestu, ja vēlaties savā kontā iespējot dinamiskās rindas lapas.

Tīkla malas adapteris Papildu resursi

Mūsu tīkla malas adapteri ir pilnībā aprakstīti tehniskajā rokasgrāmatā. Tehniskais ceļvedis ir pieejams Queue-Fair portālā > palīdzības sadaļā vai arī varat pieprasītkopiju no mums. Plašāku informāciju par katru no adapteriem var atrast arī katra GitHub repozitorija README.md.


REST API

Queue-Fair nodrošina izstrādātājiem piekļuvi sešiem REST API moduļiem. Lai izmantotu API, jums būs nepieciešams Queue-Fair konts. Lai iespējotu API piekļuvi savam kontam, lūdzu, sazinieties ar Queue-Fair atbalsta dienestu. Mūsu REST API moduļi atbilst OpenAPI, RFC 7807 un RFC 3339 standartiem.

Mūsu API moduļu kopums ir visaptverošs - visu, ko varat darīt portālā, varat darīt arī ar API, izņemot portāla lietotāju pārvaldību, kas ir izslēgta konfidencialitātes apsvērumu dēļ.

Katrs API modulis ir pilnībā dokumentēts vietnē api.queue-fair.net, kur atradīsiet arī Swagger interfeisu, lai atvieglotu lietošanu un testēšanu. Lai nodrošinātu drošību, visi API izsaukumi ir aizsargāti ar drošu TLS šifrēšanu, un tiem ir nepieciešama API atslēga, kas ir specifiska jūsu kontam.

API moduļi

Ziņošanas API

Tiešraides, reāllaika ziņojumi, vēsturiskie ziņojumi un apkopotā rindas statistika.

Rindu pārvaldības API

Programmētai rindu izveidei un modificēšanai reālajā laikā.

Kontu pārvaldības API

Konta iestatījumu skatīšanai un atjaunināšanai.

Aktīvu pārvaldības API

Google CDN apkalpotajās rindas lapās izmantoto aktīvu pārvaldībai.

Prezentācijas API

Lai mainītu jebkuru rindas lappušu HTML aspektu un atjauninātu un radītu variantus.

Aktivizēšanas API

Lai konfigurētu aktivizēšanas noteikumus, kas nosaka, kuras vietnes lapas var izraisīt rindu un kura lapa tiek rādīta.



Dinamiskās rindas lapas

Varat arī mainīt rindas lapas uzreiz, neatjauninot datu bāzi, izmantojot portāla vai prezentācijas API - sazinieties ar atbalsta dienestu, lai saņemtu sīkāku informāciju un savā kontā iespējotu dinamiskās rindas lapas.

REST API papildu resursi

Saskaņā ar RFC 7807 prasībām dokumentāciju par kļūdu ziņojumiem, ko var atgriezt mūsu REST API moduļi, varat atrast vietnē queue-fair.com/api-error.


Vietējās lietotnes

Queue-Fair izskatās lieliski gan mobilajās pārlūkprogrammās, gan arī galddatoros un klēpjdatoros.

Queue-Fair varat izmantot arī tieši savās iOS un Android lietotnēs, kā arī React Native lietotnēs iOS, Android, Windows un MacOS, lai aizsargātu resursietilpīgas darbības vai operācijas.

Queue-Fair lietojumprogrammu adapteri izmanto Webklientu, lai parādītu pielāgotus rindas displejus jūsu lietotājiem, kad jūsu pakalpojumi ir pārāk aizņemti, ar elastību un lietošanas ērtumu, ko nodrošina Queue-Fair lietojumprogrammu adapteri. Queue-Fair Portal.

Varat lietotājus ierindot vienā rindā ar vietnes apmeklētājiem vai izveidot atsevišķu rindu lietotnes lietotājiem - tas ir atkarīgs no jums.

Tāpat kā mūsu tīmekļa rindās, katra lietotāja vieta tiek automātiski saglabāta arī tad, ja lietotājs dodas prom no jūsu lietotnes.

GitHub repozitoriji

iOS, MacOS un Apple virtuālās uzgaidāmās telpas adapteris

iOS & MacOS

Queue-Fair virtuālās uzgaidāmās telpas iOS un MacOS adaptera GitHub repozitorijs.

Android virtuālās uzgaidāmās telpas adapteris

Android

Queue-Fair virtuālās uzgaidāmās telpas adaptera Android operētājsistēmai GitHub repozitorijs.

React Native lietotnes virtuālās uzgaidāmās telpas adapteris

React Native

GitHub repozitorijs Queue-Fair virtuālās uzgaidāmās telpas adapterim React Native lietotnēm Android, iOS, MacOS un Windows.

Paziņojumi par rindu

Queue-Fair adapteris ļauj viegli nosūtīt Push paziņojumu lietotājiem, kuri neizmanto jūsu lietotni vai rindu, kad viņu kārta ir izsaukta. Adapteris automātiski pastāvīgi saglabā lietotāja vietu rindā jūsu lietotnē. Ja lietotājs dodas prom no lietotnes, lietotne paziņo Push paziņojumu serverim, ka ir jānosūta paziņojums, nosūtot saglabāto informāciju par vietu rindā kā daļu no ziņojuma uz Push paziņojumu serveri.

Tā ir tā pati tehnoloģija, ko mēs izmantojam WeQ4U lietotnē patērētājiem, kas tikai Apvienotajā Karalistē vien ir lejupielādēta aptuveni 2 miljonu reižu.

Jūsu Push paziņojumu serveris periodiski konsultējas ar Queue-Fair statusa API, lai uzzinātu, kāda ir pašlaik apkalpojamā rindas pozīcija. Ja tā ir lielāka par konkrētā lietotāja rindas pozīciju, ir pienācis laiks nosūtīt šim lietotājam paziņojumu. Ja lietotājs atgriežas rindā vai tiek nodots, pirms ir nosūtīts Push paziņojums, adapteris par to paziņo jūsu lietotnei, un jūsu lietotne paziņo Push paziņojumu serverim, ka paziņojums vairs nav nepieciešams.

Cik mums zināms, mēs esam vienīgais virtuālās uzgaidāmās telpas pakalpojumu sniedzējs, kas atbalsta šo funkciju.

Video resursi

Šeit ir videoieraksts, kurā redzams, kā darbojas vietējais lietotnes adapteris, parādot, ka lietotāja vieta tiek saglabāta pat tad, ja lietotne ir pilnībā apturēta, kā arī parādot adaptera āķus, ko lietotne izmanto, lai sūtītu Push paziņojumus.

Papildu resursi

Mūsu vietējie lietotņu adapteri ir aprakstīti tehniskajā rokasgrāmatā. Tehniskais ceļvedis ir pieejams Queue-Fair portālā > palīdzības sadaļā vai arī varat pieprasītkopiju no mums. Plašāku informāciju par katru no adapteriem, kas raksturīga iOS un Android, varat atrast arī katra GitHub repozitorija README.md.


ECommerce Adapteri

Queue-Fair var viegli pievienot jebkurai e-komercijas sistēmai, izmantojot iepriekš aprakstīto klienta puses JavaScript adapteri.

Mēs piedāvājam arī adaptera kodu darbam servera pusē ar daudziem populārākajiem e-komercijas serveriem.

GitHub repozitoriji

Magento Plugin

Magento

GitHub repozitorijs Queue-Fair virtuālās uzgaidāmās telpas adapterim Magento.

WooCommerce/PHP virtuālās uzgaidāmās telpas adapteris

WooCommerce

GitHub repozitorijs Queue-Fair virtuālās uzgaidāmās telpas adapterim WooCommerce PHP.

PrestaShop/PHP virtuālās uzgaidāmās telpas adapteris

PrestaShop

GitHub repozitorijs Queue-Fair virtuālās uzgaidāmās telpas adapterim PrestaShop lietojumprogrammai PHP.

Papildu resursi

Mūsu adapteri ir aprakstīti tehniskajā rokasgrāmatā. Tehniskais ceļvedis ir pieejams Queue-Fair portālā > palīdzības sadaļā vai arī varat pieprasītkopiju no mums.

Mums ir pieejami arī papildu ceļveži lielākajai daļai e-komercijas platformu - vienkārši pajautājiet, kuru vēlaties.


Hibrīda drošība

Varat viegli apvienot klienta puses JavaScript adaptera elastību ar papildu drošības līmeni, ko nodrošina mūsu servera puses kods.

Queue-Fair paraksta katru apmeklētāju, kuru mēs caurlaižam, ar digitālu pirkstu nospiedumu, kas ir unikāls šim apmeklētājam. Nozarē unikālais paraksts ietver arī apmeklētāja pārlūkprogrammai raksturīgu kodu, lai novērstu piekļuves žetonu koplietošanu.

Jūsu tīmekļa serveris var apstiprināt parakstu, izmantojot tikai jums un mums - nevis jūsu apmeklētājiem - zināmu noslēpumu, lai pārliecinātos, ka katrs apmeklētājs ir godīgi izturējis Queue-Fair serverus.

Tādējādi varat izmantot klienta puses JavaScript adapteri, lai nosūtītu un saņemtu apmeklētājus uz rindu un no tās, kā arī pārbaudītu, vai nav notikusi manipulācija pirms to pasūtīšanas, izmantojot minimālu servera puses kodu un izvairoties no atkarības no mūsu sistēmas.

Mūsu GitHub repozitorijos ir iekļauts parauga kods visās galvenajās tīmekļa programmēšanas valodās.

GitHub repozitoriji

PHP

PHP

GitHub repozitorijs Queue-Fair virtuālās uzgaidāmās telpas servera puses adapterim PHP.

Java

Java

GitHub repozitorijs Queue-Fair virtuālās uzgaidāmās telpas servera puses adapterim Java, tostarp JBoss un Tomcat.

Ruby

Ruby

GitHub repozitorijs Queue-Fair virtuālās uzgaidāmās telpas servera puses adapterim Ruby un (pēc izvēles) Rails valodā.

Python

Python

GitHub repozitorijs Queue-Fair virtuālās uzgaidāmās telpas servera puses adapterim Python un (pēc izvēles) Django.

.NET

.NET

Queue-Fair virtuālās uzgaidāmās telpas servera puses adaptera GitHub repozitorijs .NET, ASP un C#.

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

Node.js & JavaScript

Queue-Fair virtuālās uzgaidāmās telpas servera puses adaptera Queue-Fair servera puses adapterim Node.js un (pēc izvēles) Express GitHub repozitorijs.

Papildu resursi

Hibrīda drošības modelis ir pilnībā aprakstīts tehniskajā rokasgrāmatā. Tehniskais ceļvedis ir pieejams Queue-Fair portālā > palīdzības sadaļā vai arī varat pieprasītkopiju no mums.


Licence

Mūsu publicētais kods, kas pieejams GitHub Queue-Fair repozitorijā, ir licencēts ar MIT licenci, kas ir viena no visatļautākajām atvērtā koda licencēm.


Vēlaties uzzināt, kā darbojas Queue-Fair?