Kehittäjän resurssit



Queue-Fair:n lisääminen

Queue-Fair Virtual Waiting Room on helppo lisätä moniin erilaisiin verkko- ja sovellusalustoihin muutamassa minuutissa. Käytä vain yhtä adaptereistamme. Lisätietoja parhaasta tavasta integroida Queue-Fair olemassa olevaan järjestelmääsi löydät teknisestä oppaasta tai Queue-Fair-portaalin > Ohje-osiosta. Jos etsit tietoa siitä, miten voit estää botteja tai ihmisiä tekemästä useita tilauksia tai suojata NFT-myyntiäsi liiallisilta kaasumaksuilta, voit lukea tämän yleiskatsauksen tai tutustua yksityiskohtaisesti Portaalin Turvallisuusopas-osiossa.

Asiakaspuolen sovitin

Verkkosivustoilla yksinkertaisin tapa integroitua Queue-Fair:n kanssa on lisätä sivuillesi Client-Side Queue-Fair Adapter JavaScript -tunniste. Voit lisätä sovittimen turvallisesti kaikkiin sivustosi sivuihin ja määrittää Queue-Fair-portaalin aktivointisääntöjen avulla, mitkä sivut voivat heittää jonon.

Koska se toimii kävijöiden selaimissa, teknisesti taitava kävijä voi poistaa Client-Side Adapterin käytöstä, mutta se estää tehokkaasti ylikuormituksen, sillä vain hyvin pieni vähemmistö yrittää ohittaa jonon peukaloimalla JavaScriptiä. Useimmat asiakkaamme käyttävät Client-Side Adapteria, koska se estää tehokkaasti sivuston kaatumisen, on helppo asentaa eikä se aiheuta riippuvuutta meidän järjestelmämme ja teidän järjestelmänne välille.

Voit lisätä suojauskerroksen korvaamalla JavaScript-tunnisteen palvelinpuolen sovittimella tai yhdistämällä JavaScript-sovittimen joustavuuden tällä sivulla kuvattuun hybriditurvamalliin; molemmat menetelmät ovat tällöin turvallisia.

Yksi koodirivi

Jos haluat lisätä asiakaspuolen sovittimen sivustoosi, lisää vain seuraava koodirivi tiedostoon <head> osio sivuillasi:

Lisää virtuaalinen odotushuone sivustoosi tällä yhdellä koodirivillä ja estä sivuston kaatuminen.

Jotkut asiakkaat lisäävät sanan defer tagiin, mikä aiheuttaa sen, että Adapter-skripti ladataan sivun jäsentämisen rinnalla ja että skriptin suoritus käynnistyy vierailijan selaimessa vasta, kun sivun jäsentäminen on päättynyt (eli yleensä sen jälkeen, kun muut sivulla olevat skriptit ovat päättyneet).

Lykkäys-sanan lisääminen voi joissakin tapauksissa parantaa Time to First Paint -aikaa pienellä sekunnin murto-osalla, mutta jos päätät tehdä tämän, se tarkoittaa, että kaikki kävijät, joiden pitäisi olla jonossa, näkevät suojatun sivusi sekunnin murto-osan pidempään ennen kuin heidät lähetetään jonoon.

Google Tag Manager

Tarjoamme myös JavaScript Adapter Tagin Google Tag Managerin kautta. Etsi Queue-Fair yhteisön mallien galleriasta, kohdasta Lisää tagi. Huomaa, että jotkin mainosten estolaitteet estävät gtm.js-masterin lataamisen Googlelta, mikä estää kaikki Google Tag Managerin toiminnot, mukaan lukien sovittimen suorittamisen näille kävijöille.Virtual Waiting Room -tunnisteemme Google Tag Managerille

GitHub-repositoriot

Google Tag Manager

Google Tag Manager

Queue-Fair Virtual Waiting Room -virtuaali-odotushuoneen GitHub-tietovarasto Google Tag Managerin asiakaspuolen sovitin-tagille..

Dynaamiset jonosivut

Kaikki haluamasi tiedot voidaan välittää sivustoltasi palvelimillemme ja kävijöiden näkemille jonosivuille käyttämällä data-queue-fair-extra-attribuuttia, joka on käytettävissä Client-Side JavaScript Tagissa ja Google Tag Managerin toteutuksessa. Ota yhteyttä asiakaspalveluun, jos haluat ottaa dynaamiset jonosivut käyttöön tililläsi.

Tämän ominaisuuden avulla voit mukauttaa jonosivuja lennossa. Voit myös käyttää Queue-Fair:ta siirtääksesi tietoja, jotka lähetät meille kävijöiden kanssa takaisin sivustollesi, kun heidät ohitetaan jonon kautta, lisäturvaksi.

Tarjoamme myös dynaamisen jonosivun API: n, joka käyttää ylimääräisiä tietoja jonosivun minkä tahansa näkökohdan mukauttamiseen, joten voit luoda yhden jonon koko sivustollesi ja mukauttaa sitä automaattisesti eri tapahtumille tai tuotteille sivustollasi ilman, että sinun tarvitsee tehdä muutoksia jonosivuihisi Queue-Fair-portaalissa

.



Shopify, Wordpress & WooCommerce

Jos käytät Wordpress-pohjaista sivustoa, kuten WooCommerce-ostoskorijärjestelmää, voit helposti lisätä Client-Side JavasScript Adapter -tunnisteen Wordpress Insert Headers & Footers Plugin -lisäosan avulla ilman, että sinun tarvitsee muuttaa mitään teemoja tai koskea Wordpress-koodiin.

Lataa vain Insert Headers & Footers Plugin, pura se /wp-content/plugins/-kansioon, aktivoi plugin Plugins-valikossa, avaa plugin Asetukset-valikosta, lisää tagi Scripts in Header -kohtaan kuten kuvassa näkyy, paina Save sivun alareunassa, ja olet valmis!

Shopify on yhtä helppoa - tässä on ohjeet Queue-Fair Client-Side JavaScript Adapterin lisäämiseksi Shopify-kauppaan.

Queue-Fair-portaalin kojelauta

Asiakaspuolen sovitin Lisäresurssit

Asiakaspuolen sovitin kuvataan kokonaisuudessaan teknisessä oppaassa. Tekninen opas on saatavilla Queue-Fair-portaalissa > Ohje-osiossa, tai voit pyytää kopion meiltä.


Palvelinpuolen sovittimet

Asiakaspuolen sovitin toimii JavaScript-ohjelmana vierailijoiden selaimissa, kun taas Queue-Fair-palvelinpuolen sovittimet toimivat verkkopalvelimella.

Web-palvelinsovittimet

Tämä tarkoittaa, että verkkopalvelimesi voi hyödyntää lisäturvaominaisuuksia, joilla estetään pääsy henkilöiltä, joita ei ole asetettu jonoon. Tämä tarkoittaa myös sitä, että verkkopalvelimesi välttää Adapter-skriptiä sisältävien sivujen luomisen ja tarjoilun aiheuttaman kuormituksen.

Queue-Fair-palvelinpuolen sovitinkirjastojen lisääminen vie vain muutaman minuutin, ja sovittimen aktivoiminen ja käyttäminen vaatii vain vähäisiä koodimuutoksia.

Useimmat asiakkaamme aloittavat asiakaspuolen JavaScript-sovittimella ja siirtyvät palvelinpuolen sovittimeen vain silloin, kun siihen on erityinen liiketoiminnallinen tarve.

Yksinkertainen ja turvallinen tila

Queue-Fair-palvelinpuolen sovittimet voivat toimia yksinkertaisessa tai turvallisessa tilassa.

Yksinkertaisessa tilassa kaikki vierailijat lähetetään Queue-Fair-palvelimille laskettavaksi riippumatta siitä, onko jonoa muodostunut vai ei. Kun jonoa ei ole, kävijät palautetaan Web-palvelimellesi välittömästi ilman jonosivua - mutta Web-palvelimesi tarvitsee allekirjoituksen varmistaakseen, että vain jonon ohittaneet henkilöt pääsevät käyttämään suojattuja resurssejasi.

Turvallisessa tilassa vierailijat lähetetään Queue-Fair-palvelimille vain silloin, kun jono on olemassa. Verkkopalvelimesi ottaa yhteyttä jonopalvelimiin suoraan tämän määrityksen tekemiseksi. Kävijät allekirjoitetaan edelleen turvallisesti digitaalisesti riippumatta siitä, näkyykö jonosivu vai ei.

Vikasietotilaa suositellaan päivittäisille jonoille. Yksinkertainen tila sopii ajoitettuun tapahtumaan, kun odotat tuhansia ihmisiä, sillä se poistaa viiveitä, jotka johtuvat tarkistuskutsusta verkkopalvelimeltasi jonopalvelimillemme, mikä tarkoittaa, että voit lähettää ihmisiä jonoon tehokkaammin.

GitHub-repositoriot

PHP Virtual Waiting Room -sovitin') ?>

PHP

Queue-Fair Virtual Waiting Room Server-Side Adapterin GitHub-arkisto PHP:llä.

Java Virtual Waiting Room -sovitin

Java

Queue-Fair Virtual Waiting Room Server-Side Adapter for Java, mukaan lukien JBoss ja Tomcat, GitHub-tietovarasto.

Ruby Virtual Waiting Room -sovitin

Ruby

Queue-Fair Virtual Waiting Room -palvelinpuolen sovittimen GitHub-tietovarasto Ruby- ja (valinnaisesti) Rails-kielellä..

Python Virtual Waiting Room -sovitin

Python

Queue-Fair Virtual Waiting Room Server-Side Adapterin GitHub-arkisto Pythonilla ja (valinnaisesti) Djangolla.

dotNet Virtual Waiting Room -sovitin

.NET

Queue-Fair Virtual Waiting Room Server-Side Adapter for .NET, ASP and C# -palvelinten GitHub-repository.

Node.js & JavaScript virtuaalinen odotushuoneen sovitin

Node.js & JavaScript

Queue-Fair Virtual Waiting Room Server-Side Adapterin GitHub-arkisto Node.js:lle ja (valinnaisesti) Expressille.



Dynaamiset jonosivut

Kuten asiakaspuolen sovittimen kohdalla, kaikki haluamasi tiedot voidaan siirtää verkkopalvelimeltasi palvelimillemme ja kävijöiden näkemille jonosivuille välittämällä nämä tiedot palvelinpuolen sovitinkutsussa. Tämä helpottaa dynaamisen jonosivun tai muun lennossa tapahtuvan mukauttamisen tekemistä samalla tavalla - kaikki Client-Side Adapterin ominaisuudet ovat täysin tuettuja. Ota yhteyttä asiakaspalveluun, jos haluat ottaa dynaamiset jonosivut käyttöön tililläsi.

Palvelinpuolen sovitin Lisäresurssit

Palvelinpuolen sovittimet on kuvattu yksityiskohtaisesti teknisessä oppaassa. Tekninen opas on saatavilla Queue-Fair-portaalissa > Ohje-osiossa, tai voit pyytää kopion meiltä. Löydät lisätietoja kustakin sovittimesta myös kunkin GitHub-arkiston README.md-tiedostosta.


Verkon reunasovittimet

Queue-Fair Network-Edge -sovittimet toimivat CDN- tai pilvipalveluntarjoajan kehyksen sisällä, eivätkä kävijöiden selaimissa tai alkuperäisellä palvelimellasi.

Lambda- ja CDN-palveluntarjoajien sovittimet

Tämä antaa saman turvallisuuden kuin palvelinpuolen sovitin ja saman kuormitussuojan kuin Direct Link.

Queue-Fair Network-Edge Adapter -kirjastojen lisääminen vie vain muutaman minuutin, ja pilvipalveluntarjoajasi tarvitsee vain minimaalisia koodimuutoksia aktivoidakseen ja ajaakseen sovittimen, joka yleensä otetaan käyttöön Lambda-toimintona tai Edge Workerina.

Yksinkertainen ja turvallinen tila

Kuten palvelinpuolen sovittimemme, myös verkkojohtosovittimemme voivat toimia yksinkertaisessa tai turvallisessa tilassa.

Saatavilla olevat sovittimet

Amazon AWS CloudFront Network-Edge Virtual Waiting Room -sovitin') ?>

CloudFront

Amazon AWS CloudFront Network-Edge Virtual Waiting Room Adapter.

Cloudflare Network-Edge Virtual Waiting Room -sovitin

Cloudflare

Cloudflare Network-Edge Virtual Waiting Room -sovitin

Fastly Network-Edge Virtual Waiting Room Adapter - virtuaalinen odotushuoneen sovitin

Fastly

Fastly Network-Edge Virtual Waiting Room Adapter..

Akamai Network-Edge Virtual Waiting Room -sovitin

Akamai

Akamai Network-Edge Virtual Waiting Room Adapter.



Dynaamiset jonosivut

Kuten asiakaspuolen sovittimessa, kaikki haluamasi tiedot voidaan siirtää sivustoltasi palvelimillemme ja kävijöiden näkemille jonosivuille välittämällä nämä tiedot sovituskutsussa. Tämä helpottaa dynaamisen jonosivun tai muun lennossa tapahtuvan mukauttamisen tekemistä samalla tavalla - kaikki Client-Side Adapterin ominaisuudet ovat täysin tuettuja. Ota yhteyttä asiakaspalveluun, jos haluat ottaa dynaamiset jonosivut käyttöön tililläsi.

Network-Edge-sovitin Lisäresurssit

Network-Edge-sovittimemme on kuvattu yksityiskohtaisesti teknisessä oppaassa. Tekninen opas on saatavilla Queue-Fair-portaalissa > Ohje-osiossa, tai voit pyytää kopion meiltä. Löydät lisätietoja kustakin sovittimesta myös kunkin GitHub-tietovaraston README.md-tiedostosta.


REST API:t

Queue-Fair tarjoaa kehittäjille pääsyn kuuteen REST API -moduuliin. Tarvitset Queue-Fair-tilin voidaksesi käyttää API:ta. Ota yhteyttä Queue-Fair:n asiakastukeen, jos haluat ottaa API-käytön käyttöön tilillesi. REST API -moduulit ovat OpenAPI-, RFC 7807- ja RFC 3339 -standardien mukaisia.

API-moduulivalikoimamme on kattava - voit tehdä kaiken, mitä voit tehdä portaalissa, myös API:n avulla, lukuun ottamatta portaalin käyttäjien hallintaa, joka on suljettu pois tietosuojasyistä.

Jokainen API-moduuli on dokumentoitu kokonaisuudessaan osoitteessa api.queue-fair.net, josta löydät myös Swagger-käyttöliittymän käytön ja testauksen helpottamiseksi. Turvallisuuden vuoksi kaikki API-kutsut on suojattu turvallisella TLS-salauksella, ja ne vaativat tilisi API-avaimen.

API-moduulit

Raportointi API

reaaliaikaisia raportteja, historiallisia raportteja ja yhteenlaskettuja jonotilastoja varten.

Jononhallinta API

Jonojen luomiseen ja muokkaamiseen ohjelmallisesti reaaliajassa.

Tilinhallinta API

Tilin laajuisten asetusten tarkasteluun ja päivittämiseen.

Omaisuudenhallinta API

Google CDN:n tarjoamien jonosivujen käyttämien resurssien hallintaan.

Esitys-API

Jonosivujen HTML-muodon muuttamiseen ja vaihtoehtojen päivittämiseen ja luomiseen lennossa.

Aktivointi API

Aktivointisääntöjen määrittämiseen, jotka määrittävät, mitkä sivut sivustossasi voivat käynnistää jonon ja mikä sivu näytetään.



Dynaamiset jonosivut

Voit myös muokata jonosivuja lennossa ilman, että sinun tarvitsee päivittää tietokantaa portaalin tai esitysliittymän avulla - ota yhteyttä asiakaspalveluun saadaksesi lisätietoja ja ottaaksesi dynaamiset jonosivut käyttöön tililläsi.

REST API Lisäresurssit

Kuten RFC 7807 edellyttää, löydät dokumentaatiota virheilmoituksista, joita REST API -moduulit voivat palauttaa, osoitteesta queue-fair.com/api-error.


Natiivit sovellukset

Queue-Fair näyttää hyvältä mobiiliselaimissa sekä pöytätietokoneissa ja kannettavissa tietokoneissa.

Voit myös käyttää Queue-Fair:ta suoraan natiivissa iOS- ja Android-sovelluksissasi sekä React Native -sovelluksissa iOS:ssä, Androidissa, Windowsissa ja MacOS:ssä suojellaksesi resurssi-intensiivisiä toimintoja tai operaatioita.

Queue-Fair-sovellussovittimet käyttävät WebClient-asiakasta näyttämään käyttäjille mukautettuja jononäyttöjä, kun palvelut ovat liian kiireisiä. Queue-Fair Portal.

Voit asettaa käyttäjät samaan jonoon verkkosivuston kävijöiden kanssa tai luoda erillisen jonon sovelluksen käyttäjille - se on sinun päätettävissäsi.

Aivan kuten verkkopohjaiset jonot, jokaisen käyttäjän paikka tallentuu automaattisesti, jos hän siirtyy pois sovelluksestasi.

GitHub-repositoriot

iOS-, MacOS- ja Apple Virtual Waiting Room -sovitin

iOS & MacOS

Queue-Fair Virtual Waiting Room iOS- ja MacOS-sovittimen GitHub-arkisto.

Android Virtual Waiting Room -sovitin

Android

GitHub-arkisto Queue-Fair Virtual Waiting Room -sovittimelle Androidille.

React Native -sovellus Virtuaalinen odotushuoneen sovitin

React Native

Queue-Fair Virtual Waiting Room Adapterin GitHub-arkisto React Native -sovelluksille Androidille, iOS:lle, MacOS:lle ja Windowsille.

Jonoilmoitukset

Queue-Fair-sovittimen avulla on helppo lähettää Push-ilmoitus käyttäjille, jotka eivät käytä sovellusta tai jonoa, kun heidän vuoronsa kutsutaan. Sovitin tallentaa automaattisesti käyttäjän paikan jonossa pysyvästi sovellukseesi. Jos käyttäjä siirtyy pois sovelluksestasi, sovelluksesi kertoo Push-ilmoituspalvelimellesi, että ilmoitus on lähetettävä, ja lähettää tallennetun jonon sijaintitiedon osana viestiä Push-ilmoituspalvelimellesi.

Kyseessä on sama tekniikka, jota käytämme WeQ4U-kuluttajasovelluksessamme, jota on ladattu noin 2 miljoonaa kertaa pelkästään Yhdistyneessä kuningaskunnassa.

Push-ilmoituspalvelimesi käyttää Queue-Fair Status API:ta määräajoin kysyäkseen, mikä jonon sijainti on tällä hetkellä käytössä. Kun tämä on suurempi kuin tietyn käyttäjän jonotusasema, on aika lähettää kyseiselle käyttäjälle ilmoitus. Jos käyttäjä palaa jonoon tai hänet ohitetaan ennen Push-ilmoituksen lähettämistä, sovitin ilmoittaa sovelluksellesi, ja sovellus kertoo Push-ilmoituspalvelimelle, että ilmoitusta ei enää tarvita.

Tietojemme mukaan olemme ainoa virtuaalisen odotushuoneen tarjoaja, joka tukee tätä ominaisuutta.

Videoresurssit

Tässä on video Native App Adapterista toiminnassa, jossa näytetään, että käyttäjän paikka tallennetaan, vaikka sovellus pysäytettäisiin kokonaan, ja näytetään myös Adapterin koukut, joita sovelluksesi käyttää Push-ilmoitusten lähettämiseen.

Lisäresurssit

Natiivisovellussovittimemme on kuvattu teknisessä oppaassa. Tekninen opas on saatavilla Queue-Fair-portaalissa > Ohje-osiossa, tai voit pyytää kopion meiltä. Löydät myös lisätietoja kustakin sovittimesta, jotka ovat iOS- ja Android-käyttöjärjestelmäkohtaisia, kunkin GitHub-tietovaraston README.md-tiedostosta.


Sähköisen kaupankäynnin sovittimet

Queue-Fair voidaan lisätä helposti mihin tahansa verkkokauppajärjestelmään käyttämällä edellä kuvattua Client-Side JavaScript Adapteria.

Tarjoamme myös Adapter-koodia, joka toimii palvelinpuolella monien suosittujen verkkokauppapalvelimien kanssa.

GitHub-repositoriot

Magento Plugin

Magento

Magenton Queue-Fair Virtual Waiting Room -sovittimen GitHub-arkisto.

WooCommerce/PHP virtuaalinen odotushuoneen sovitin

WooCommerce

Queue-Fair Virtual Waiting Room -sovittimen GitHub-arkisto WooCommerce-ohjelmalle PHP:llä.

PrestaShop/PHP virtuaalinen odotushuoneen sovitin

PrestaShop

GitHub-tietovarasto Queue-Fair Virtual Waiting Room Adapter for PrestaShop for PHP.

Lisäresurssit

Sovittimet on kuvattu teknisessä oppaassa. Tekninen opas on saatavilla Queue-Fair-portaalissa > Ohje-osiossa, tai voit pyytää kopion meiltä.

Meillä on saatavilla myös lisäoppaita useimpiin verkkokauppa-alustoihin - kysy vain haluamaasi.


Hybriditurva

Voit helposti yhdistää asiakaspuolen JavaScript-sovittimen joustavuuden ja palvelinpuolen koodin tarjoaman lisäturvakerroksen.

Queue-Fair allekirjoittaa jokaisen kuljettamamme kävijän digitaalisella sormenjäljellä, joka on yksilöllinen kyseiselle kävijälle. Alalla ainutlaatuista on, että allekirjoitus sisältää myös vierailijan selaimelle ominaisen koodin, jolla estetään pääsykoodien jakaminen.

Verkkopalvelimesi voi validoida allekirjoituksen käyttämällä salaisuutta, jonka vain sinä ja me tunnemme - ei vierailijasi - varmistaaksemme, että jokainen vierailija on läpäissyt Queue-Fair-palvelimet oikeudenmukaisesti.

Voit siis käyttää Client-Side JavaScript Adapteria lähettämään ja vastaanottamaan kävijöitä jonoon ja jonosta sekä tarkistamaan, ettei niitä ole peukaloitu ennen kuin ne tilaavat minimaalisella Server-Side-koodilla, ja välttämään riippuvuuden luomista järjestelmästämme.

GitHub-repositoriossamme on esimerkkikoodia kaikilla tärkeimmillä verkko-ohjelmointikielillä.

GitHub-repositoriot

PHP

PHP

Queue-Fair Virtual Waiting Room Server-Side Adapterin GitHub-arkisto PHP:llä.

Java

Java

Queue-Fair Virtual Waiting Room Server-Side Adapter for Java, mukaan lukien JBoss ja Tomcat, GitHub-tietovarasto.

Ruby

Ruby

Queue-Fair Virtual Waiting Room Server-Side Adapterin GitHub-tietovarasto Ruby- ja (valinnaisesti) Rails-kielellä.

Python

Python

Queue-Fair Virtual Waiting Room Server-Side Adapterin GitHub-arkisto Pythonilla ja (valinnaisesti) Djangolla.

.NET

.NET

Queue-Fair Virtual Waiting Room Server-Side Adapter for .NET, ASP and C# -palvelinten GitHub-repository.

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

Node.js & JavaScript

Queue-Fair Virtual Waiting Room Server-Side Adapterin GitHub-arkisto Node.js:lle ja (valinnaisesti) Expressille.

Lisäresurssit

Hybridi-turvamalli kuvataan kokonaisuudessaan teknisessä oppaassa. Tekninen opas on saatavilla Queue-Fair-portaalissa > Ohje-osiossa, tai voit pyytää kopion meiltä.


Lisenssi

Julkaisemamme koodi, joka on saatavilla GitHub Queue-Fair Repository -palvelussa, on lisensoitu MIT-lisenssillä, joka on yksi avoimen lähdekoodin sallivimmista lisensseistä.


Haluatko tietää, miten Queue-Fair toimii?