Fejlesztői erőforrások



Queue-Fair hozzáadása

A Queue-Fair virtuális váróterem egyszerűen, percek alatt hozzáadható a legkülönbözőbb webes és alkalmazásplatformokhoz. Csak használja az egyik adapterünket. A Queue-Fair meglévő rendszerébe való integrálásának legjobb módjáról további információkat a Műszaki útmutatóban vagy a Queue-Fair portál > Súgó szakaszban talál. Ha információt keres arról, hogyan akadályozhatja meg, hogy botok vagy emberek többszörös megrendeléseket adjanak le, vagy hogyan védheti meg NFT-értékesítéseit a túlzott gázdíjaktól, akkor olvassa el ezt az áttekintést, vagy teljes részletességgel tájékozódhat a portál Biztonsági útmutató részében.

Az ügyféloldali adapter

Weboldalak esetében a Queue-Fair integráció legegyszerűbb módja, ha hozzáadja az oldalakhoz a kliensoldali Queue-Fair adapter JavaScript taget. Az adaptert biztonságosan hozzáadhatja a webhelye összes oldalához, és a Queue-Fair portálon található aktiválási szabályok segítségével meghatározhatja, hogy mely oldalak dobhatnak sorba.

Mivel a látogatók böngészőjében fut, a kliensoldali adaptert a technikailag képzett látogatók letilthatják, de nagyon hatékonyan megakadályozza a túlterhelést, mivel csak az emberek nagyon kis kisebbsége próbálja meg kihagyni a várólistát a JavaScript manipulálásával. A legtöbb ügyfelünk azért használja a Client-Side Adaptert, mert hatékonyan megakadályozza a webhely összeomlását, egyszerűen telepíthető, és nem teremt függőséget a mi és az Ön rendszere között.

Biztonsági réteget adhat hozzá a JavaScript-címke szerveroldali adapterrel való helyettesítésével, vagy kombinálhatja a JavaScript-adapter rugalmasságát az ezen az oldalon ismertetett hibrid biztonsági modellel; ekkor mindkét módszer biztonságos.

Egyetlen kódsor

A kliensoldali adapter hozzáadásához a webhelyhez csak a következő egyetlen kódsort kell hozzáadni a következő weboldalhoz <head> az oldalai szakaszában:

Adja hozzá virtuális várótermünket a weboldalához ezzel az egyetlen kódsorral, és akadályozza meg a weboldal összeomlását.

Néhány ügyfél hozzáadja a szót defer a címkéhez, ami az Adapter szkript letöltését az oldal elemzésével párhuzamosan okozza, és a szkript végrehajtását csak akkor kezdi el a látogató böngészőjében, amikor az oldal elemzése befejeződött (tehát jellemzően az oldal egyéb szkriptjeinek befejezése után).

A halasztás szó hozzáadása bizonyos esetekben a másodperc töredékével javíthatja az első festékig eltelt időt, de ha ezt választja, akkor ez azt jelenti, hogy minden olyan látogató, akinek sorba kellene állnia, a másodperc töredékével tovább látja a védett oldalt, mielőtt a sorba kerülne.

Google Tag Manager

A JavaScript Adapter Tag-et is biztosítjuk a Google Tag Manager-en keresztül. Keressen rá a Queue-Fair-ra a Közösségi sablonok galériájában, a Címke hozzáadása alatt. Felhívjuk figyelmét, hogy egyes hirdetésblokkolók megakadályozzák a gtm.js mester Google-ból történő letöltését, ami blokkolja a Google Tag Manager minden műveletét, beleértve az Adapter futtatását is ezen látogatók számára.Virtuális váróterem címke a Google Tag Manager számára

GitHub tárolók

Google Tag Manager

Google Tag Manager

A Queue-Fair virtuális váróterem Google Client-Side Adapter Tag Google Manager kliensoldali adapter tag GitHub tárolója.

Dinamikus várólistás oldalak

A kliensoldali JavaScript tagben és a Google Tag Manager implementációban elérhető data-queue-fair-extra attribútummal bármilyen adat átadható az Ön webhelyéről a szervereinkre és a látogatók által látott Queue oldalakra. Kérjük, vegye fel a kapcsolatot ügyfélszolgálatunkkal, ha dinamikus várólistás oldalakat szeretne engedélyezni fiókjában.

Ezzel a funkcióval menet közben is testre szabhatja a várólistás oldalakat. A Queue-Fair-t arra is használhatja, hogy a látogatókkal együtt küldött adatokat visszaadja az oldalának, amikor a várólistán áthaladnak, a biztonság további szintje érdekében.

Egy dinamikus várólista API-t is biztosítunk, amely az extra adatokat a várólista-oldal bármely aspektusának testreszabásához használja, így létrehozhat egy várólistát az egész webhelye számára, és automatikusan testre szabhatja azt a webhely különböző eseményeihez vagy termékeihez, anélkül, hogy a Queue-Fair portálon

bármilyen változtatást kellene végrehajtania a várólista-oldalain.



Shopify, Wordpress & WooCommerce

Ha Wordpress-alapú webhelyet használ, például a WooCommerce bevásárlókosár-rendszert, akkor a Wordpress Insert Headers & Footers Plugin segítségével könnyen hozzáadhatja a Client-Side JavasScript Adapter taget anélkül, hogy módosítania kellene a témáit, vagy hozzá kellene nyúlnia bármilyen Wordpress-kódhoz.

Csak töltsd le a Insert Headers & Footers Plugin-t, csomagold ki a /wp-content/plugins/ mappába, aktiváld a plugint a Plugins menüben, nyisd meg a plugint a Settings menüben, add hozzá a címkét a Scripts in Headerhez a képen látható módon, nyomd meg a Save-t az oldal alján, és kész is vagy!

A Shopify ugyanilyen egyszerű - itt találja az utasításokat a Queue-Fair Client-Side JavaScript adapter hozzáadásához a Shopify áruházához.

A Queue-Fair portál műszerfala

Ügyféloldali adapter További erőforrások

Az ügyféloldali adaptert teljes körűen ismerteti a Műszaki útmutató. A Műszaki útmutató elérhető a Queue-Fair portál > Súgó szakaszban, vagy kérhet tőlünk egy példányt.


Kiszolgálóoldali adapterek

Míg az ügyféloldali adapter JavaScriptben fut a látogatók böngészőjében, a Queue-Fair kiszolgálóoldali adapterek a webszerverén futnak.

Webkiszolgáló adapterek

Ez azt jelenti, hogy a webkiszolgáló további biztonsági funkciókat használhat ki, hogy megtagadja a hozzáférést azoktól, akik nem kerültek sorba. Ez azt is jelenti, hogy a webszerver elkerülheti az Adapter scriptet tartalmazó oldalak generálásával és kiszolgálásával járó terhelést.

A Queue-Fair szerveroldali adapterkönyvtárak hozzáadása csak néhány percet vesz igénybe, minimális kódmódosítással az adapter aktiválásához és futtatásához.

A legtöbb ügyfelünk a kliensoldali JavaScript-adapterrel kezdi, és csak akkor lép át a szerveroldali adapterre, ha erre konkrét üzleti igény van.

Egyszerű és biztonságos mód

A Queue-Fair kiszolgálóoldali adapterek egyszerű vagy biztonságos üzemmódban működhetnek.

Egyszerű módban minden látogatót a Queue-Fair-kiszolgálóknak küldenek számolásra, függetlenül attól, hogy kialakult-e sor vagy sem. Ha nincs sorban állás, akkor a látogatók azonnal visszakerülnek a Webkiszolgálóra, anélkül, hogy sorban állás oldalt látnának - de a Webkiszolgálónak szükséges aláírással, hogy csak a sorban állás által átadott személyek férhessenek hozzá a védett erőforrásokhoz.

Biztonságos módban a látogatók csak akkor kerülnek a Queue-Fair-kiszolgálókhoz, ha van várólista. A webszerver közvetlenül a várólista-kiszolgálóinkkal konzultál, hogy ezt a döntést meghozza. A látogatókat továbbra is biztonságosan digitálisan aláírják, függetlenül attól, hogy megjelenik-e a várólista oldal vagy sem.

A Biztonságos mód a napi sorban állásokhoz ajánlott. Az Egyszerű mód megfelelő egy időzített eseményhez, amikor több ezer embert vár, mivel kiküszöböli a webszerveréről a várólista-kiszolgálóinkhoz történő ellenőrző hívás miatti késleltetést, ami azt jelenti, hogy hatékonyabban küldhet embereket a várólistára.

GitHub tárolók

PHP virtuális váróterem adapter') ?>

PHP

A Queue-Fair Virtual Waiting Room szerveroldali adapter PHP nyelven készült GitHub tárolója.

Java virtuális váróterem adapter

Java

A Queue-Fair Virtual Waiting Room szerveroldali adapter GitHub-tárháza Java, beleértve a JBoss és Tomcat alkalmazásokat is.

Ruby virtuális váróterem adapter

Ruby

A Queue-Fair Virtual Waiting Room szerveroldali adapter GitHub tárolója Ruby és (opcionálisan) Rails nyelven.

Python virtuális váróterem adapter

Python

A Queue-Fair Virtual Waiting Room szerveroldali adapter GitHub tárolója Python és (opcionálisan) Django nyelven.

dotNet virtuális váróterem adapter

.NET

A Queue-Fair Virtual Waiting Room kiszolgálóoldali adapter GitHub-tárháza .NET, ASP és C# számára.

Node.js & JavaScript virtuális váróterem adapter

Node.js & JavaScript

A Queue-Fair Virtual Waiting Room szerveroldali adapter GitHub-tárháza Node.js és (opcionálisan) Express számára.



Dinamikus várólistás oldalak

Az ügyféloldali adapterhez hasonlóan a kiszolgálóoldali adapter hívásában átadva ezeket az információkat, a webszerveréről bármilyen kívánt adat átadható a szervereinknek és a látogatói által látott váróoldalaknak. Ez ugyanúgy megkönnyíti a dinamikus váróoldalak vagy más, menet közbeni testreszabást - az ügyféloldali adapter minden funkciója teljes mértékben támogatott. Kérjük, vegye fel a kapcsolatot az ügyfélszolgálattal, ha a Dynamic Queue Pages-t szeretné engedélyezni fiókjában.

Kiszolgálóoldali adapter További erőforrások

Kiszolgálóoldali adaptereinket teljes körűen ismerteti a Műszaki útmutató. A Műszaki útmutató elérhető a Queue-Fair portál > Súgó szakaszban, vagy kérhet tőlünk egy példányt. Az egyes adapterekről további információkat találhat az egyes GitHub-tárhelyek README.md fájljában is.


Hálózati adapterek

A Queue-Fair Network-Edge adapterek a CDN vagy a felhőszolgáltató keretrendszerén belül futnak, nem pedig a látogatók böngészőjében vagy az Ön eredeti szerverén.

Lambda és CDN szolgáltató adapterek

Ez ugyanazt a biztonságot nyújtja, mint a szerveroldali adapter, és ugyanazt a terhelési védelmet, mint a Direct Link.

A Queue-Fair Network-Edge Adapter könyvtárak hozzáadása mindössze néhány percet vesz igénybe, minimális kódmódosítással a felhőszolgáltatónál az adapter aktiválásához és futtatásához, amelyet általában Lambda-funkcióként vagy Edge Workerként telepít.

Egyszerű és biztonságos mód

A szerveroldali adapterekhez hasonlóan a hálózati adapterek is működhetnek egyszerű vagy biztonságos üzemmódban.

Kapható adapterek

Amazon AWS CloudFront Network-Edge virtuális váróterem-adapter') ?>

CloudFront

Amazon AWS CloudFront Network-Edge virtuális várótermi adapter.

Cloudflare Network-Edge virtuális várótermi adapter

Cloudflare

Cloudflare Network-Edge virtuális várótermi adapter

Fastly hálózati virtuális várótermi adapter

Fastly

Fastly hálózati virtuális várótermi adapter..

Akamai Network-Edge virtuális várótermi adapter

Akamai

Akamai Network-Edge Virtual Waiting Room Adapter.



Dinamikus várólistás oldalak

Az ügyféloldali adapterhez hasonlóan az Ön webhelyéről bármilyen adat átadható a szervereinknek és a látogatói által látott váróoldalaknak, ha az adatokat az adapterhívásban adja át. Ez ugyanúgy megkönnyíti a dinamikus váróoldalak vagy más, menet közbeni testreszabást - az ügyféloldali adapter minden funkciója teljes mértékben támogatott. Kérjük, vegye fel a kapcsolatot az ügyfélszolgálattal, ha dinamikus váróoldalakat szeretne engedélyezni fiókjában.

Network-Edge adapter További erőforrások

Hálózati adaptereinket teljes körűen ismerteti a Műszaki útmutató. A Műszaki útmutató elérhető a Queue-Fair portál > Súgó szakaszban, vagy kérhet tőlünk egy példányt. Az egyes adapterekről további információkat találhat az egyes GitHub-tárhelyek README.md fájljában is.


REST API-k

A Queue-Fair hat REST API modulhoz biztosít hozzáférést a fejlesztőknek. Az API használatához Queue-Fair-fiókra van szükség. Az API-hozzáférés engedélyezéséhez fiókja számára, kérjük, lépjen kapcsolatba a Queue-Fair ügyfélszolgálatával. REST API moduljaink megfelelnek az OpenAPI, RFC 7807 és RFC 3339 szabványoknak.

API moduljaink csomagja átfogó - bármit, amit a portálon megtehet, azt az API-val is megteheti, kivéve a portálfelhasználók kezelését, amely adatvédelmi okokból kizárt.

Minden API-modul teljes mértékben dokumentálva van az api.queue-fair.net oldalon, ahol egy Swagger-interfész is található a könnyebb használat és tesztelés érdekében. A biztonság érdekében minden API-hívás biztonságos TLS-titkosítással védett, és az Ön fiókjához tartozó API-kulcsot igényel.

API modulok

Jelentési API

Élő, valós idejű jelentések, múltbeli jelentések és összesített várólista-statisztikák.

Sorbanállás-kezelő API

A várólisták programozott, valós idejű létrehozásához és módosításához.

Számlakezelő API

A fiókra vonatkozó beállítások megtekintéséhez és frissítéséhez.

Eszközkezelő API

A Google CDN által kiszolgált váróoldalak által használt eszközök kezelésére.

Prezentációs API

A várólistás oldalak HTML-jének bármely aspektusának megváltoztatásához, valamint a változatok frissítéséhez és létrehozásához menet közben.

Aktiváló API

Az aktiválási szabályok konfigurálásához, amelyek meghatározzák, hogy a webhelyen mely oldalak indíthatnak el várakozást, és melyik oldal jelenik meg.



Dinamikus várólistás oldalak

A Portál vagy a Prezentációs API segítségével menet közben is módosíthatja a váróoldalakat anélkül, hogy frissítenie kellene az adatbázist - további részletekért és a dinamikus váróoldalak engedélyezéséért forduljon az ügyfélszolgálathoz.

REST API További erőforrások

Az RFC 7807 előírásainak megfelelően a queue-fair.com/api-erroroldalon találhat dokumentációt a REST API moduljaink által visszaküldött hibaüzenetekről.


Natív alkalmazások

A Queue-Fair nagyszerűen néz ki mobil böngészőkben, valamint asztali számítógépeken és laptopokon.

A Queue-Fair-t közvetlenül natív iOS és Android alkalmazásaiban, valamint React Native alkalmazásokban is használhatja iOS, Android, Windows és MacOS rendszereken az erőforrás-igényes tevékenységek vagy műveletek védelmére.

A Queue-Fair alkalmazásadapterek egy WebClient segítségével egyéni várólista-kijelzőket jelenítenek meg a felhasználók számára, amikor a szolgáltatások túlságosan elfoglaltak, a rugalmasság és az egyszerű használat mellett. Queue-Fair Portal.

A felhasználókat beállíthatja ugyanabba a várólistába, mint a webhely látogatóit, vagy külön várólistát állíthat be az alkalmazás felhasználói számára - ez csak Önön múlik.

A webes várólistákhoz hasonlóan az egyes felhasználók helyét automatikusan elmentjük, ha az alkalmazásból is elnavigálnak.

GitHub tárolók

iOS, MacOS és Apple virtuális váróterem-adapter

iOS & MacOS

A Queue-Fair Virtual Waiting Room iOS és MacOS adapter GitHub tárolója.

Android virtuális váróterem adapter

Android

A Queue-Fair Virtual Waiting Room Adapter for Android GitHub tárolója.

React Native App virtuális váróterem adaptere

React Native

A Queue-Fair virtuális váróterem-adapter GitHub-tárhelye React Native alkalmazásokhoz Android, iOS, MacOS és Windows operációs rendszerekhez.

Sorban állás értesítések

A Queue-Fair adapter segítségével könnyen küldhet Push értesítést olyan felhasználóknak, akik nem használják az alkalmazást vagy a várólistát, amikor sorra kerülnek. A felhasználó sorban elfoglalt helyét az Adapter automatikusan tartósan tárolja az Ön alkalmazásában. Ha a felhasználó elnavigál az alkalmazástól, az alkalmazás közli a Push Notification szerverrel, hogy értesítést kell küldeni, és az üzenet részeként elküldi a tárolt várólista pozíciójára vonatkozó információt a Push Notification szervernek.

Ugyanezt a technológiát használjuk a WeQ4U fogyasztói alkalmazásunkhoz, amelyet csak az Egyesült Királyságban mintegy 2 millióan töltöttek le.

A Push-értesítés kiszolgálója rendszeresen lekérdezi a Queue-Fair Status API-t, hogy lekérdezze az aktuálisan kiszolgált várólista pozícióját. Ha ez nagyobb, mint egy adott felhasználó sorbanállási pozíciója, akkor itt az ideje, hogy elküldje a felhasználónak az értesítést. Ha a felhasználó visszatér a várólistára vagy Passed (áthaladt), mielőtt a Push-értesítés elküldésre kerülne, az adapter értesíti az Ön alkalmazását, és az Ön alkalmazása közli a Push-értesítési kiszolgálóval, hogy az értesítésre már nincs szükség.

Tudomásunk szerint mi vagyunk az egyetlen virtuális váróterem-szolgáltató, amely támogatja ezt a funkciót.

Videó források

Íme egy videó a Native App Adapterről működés közben, amely megmutatja, hogy a felhasználó helye akkor is megmarad, ha az alkalmazás teljesen leáll, és bemutatja az Adapter horgokat is, amelyeket az alkalmazás a Push értesítések küldéséhez használ.

További források

Natív alkalmazásadaptereinket a Műszaki útmutató ismerteti. A Műszaki útmutató elérhető a Queue-Fair portál > Súgó szakaszban, vagy kérhet tőlünk egy példányt. Az egyes GitHub-tárhely README.md fájljában is találhat további, iOS-re és Androidra vonatkozó információkat az egyes adapterekről.


ECommerce adapterek

A Queue-Fair könnyen hozzáadható bármely e-kereskedelmi rendszerhez a fent leírt kliensoldali JavaScript-adapter segítségével.

Adapter kódot is kínálunk a szerveroldali működéshez számos népszerű e-kereskedelmi szerverrel.

GitHub tárolók

Magento Plugin

Magento

A Queue-Fair Virtual Waiting Room Adapter for Magento GitHub tárolója.

WooCommerce/PHP virtuális váróterem adapter

WooCommerce

A Queue-Fair Virtual Waiting Room Adapter for WooCommerce for WooCommerce in PHP GitHub tárolója.

PrestaShop/PHP virtuális váróterem adapter

PrestaShop

A Queue-Fair Virtual Waiting Room Adapter for PrestaShop for PrestaShop in PHP GitHub tárolója.

További források

Adaptereinket a Műszaki útmutatóban ismertetjük. A Műszaki útmutató elérhető a Queue-Fair portál > Súgó szakaszban, vagy kérhet tőlünk egy példányt.

A legtöbb e-kereskedelmi platformhoz kiegészítő útmutatók is rendelkezésre állnak - csak kérje a kívántat.


Hibrid biztonság

Könnyedén kombinálhatja az ügyféloldali JavaScript-adapter rugalmasságát a kiszolgálóoldali kódunk által biztosított további biztonsági réteggel.

A Queue-Fair minden egyes látogatót, akit átengedünk, egy digitális ujjlenyomattal jelöl meg, amely csak az adott látogatóra jellemző. Az iparágban egyedülálló módon az aláírás a látogató böngészőjére jellemző kódot is tartalmaz, hogy megakadályozza a hozzáférési tokenek megosztását.

Az Ön webszerverén az aláírást egy csak Ön és mi - nem pedig a látogatói - által ismert titok segítségével érvényesítheti, így biztosítva, hogy minden látogató tisztességesen átjutott a Queue-Fair szerverein.

Így a kliensoldali JavaScript-adaptert használhatja a látogatók sorba küldésére és fogadására, valamint a rendelés előtti ellenőrzésre minimális szerveroldali kóddal, és elkerülheti a rendszerünktől való függőség bevezetését.

A GitHub repozitóriumunkban minden fontosabb webes programozási nyelven található példakód.

GitHub tárolók

PHP

PHP

A Queue-Fair Virtual Waiting Room szerveroldali adapter PHP nyelven készült GitHub tárolója.

Java

Java

A Queue-Fair Virtual Waiting Room szerveroldali adapter GitHub-tárháza Java, beleértve a JBoss és Tomcat alkalmazásokat is.

Ruby

Ruby

A Queue-Fair Virtual Waiting Room szerveroldali adapter GitHub tárolója Ruby és (opcionálisan) Rails nyelven.

Python

Python

A Queue-Fair Virtual Waiting Room szerveroldali adapter GitHub tárolója Python és (opcionálisan) Django nyelven.

.NET

.NET

A Queue-Fair Virtual Waiting Room kiszolgálóoldali adapter GitHub-tárháza .NET, ASP és C# számára.

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

Node.js & JavaScript

A Queue-Fair Virtual Waiting Room szerveroldali adapter GitHub-tárháza Node.js és (opcionálisan) Express számára.

További források

A hibrid biztonsági modell teljes körű leírása a Műszaki útmutatóban található. A technikai útmutató elérhető a Queue-Fair portál > Súgó szakaszban, vagy kérhet tőlünk egy példányt.


Engedély

A GitHub Queue-Fair Repositoryban elérhető közzétett kódunk a MIT Licence licenc alatt áll, amely a legengedélyesebb nyílt forráskódú licencek közé tartozik.


Szeretné tudni, hogyan működik a Queue-Fair?