Ресурси за разработчици



Добавяне на Queue-Fair

Виртуалната чакалня на Queue-Fair се добавя лесно към голямо разнообразие от уеб платформи и приложения за минути. Просто използвайте един от нашите адаптери. Можете да намерите повече информация за най-добрия начин за интегриране на Queue-Fair със съществуващата ви система в Техническото ръководство или в раздела Queue-Fair Portal > Help (Помощ). Ако търсите информация за това как да спрете ботове или хора да правят многократни поръчки или да защитите продажбите си на NFT от прекомерни такси за газ, можете да прочетете този преглед или да получите подробна информация в раздела Ръководство за сигурност на портала.

Адаптерът от страна на клиента

За уебсайтове най-простият начин за интегриране с Queue-Fair е да добавите JavaScript тага Client-Side Queue-Fair Adapter към своите страници. Можете спокойно да добавите адаптера към всички страници на вашия сайт и да използвате правилата за активиране в портала Queue-Fair, за да определите кои страници могат да хвърлят опашка.

Тъй като се изпълнява в браузърите на посетителите, адаптерът от страна на клиента може да бъде деактивиран от технически опитни посетители, но е много ефективен за предотвратяване на претоварването, тъй като само много малка част от хората ще се опитат да прескочат опашката чрез манипулиране на JavaScript. Повечето от нашите клиенти използват Client-Side Adapter, тъй като той е ефективен при предотвратяването на срив на сайта, лесен е за инсталиране и не въвежда никаква зависимост между нашата и вашата система.

Можете да добавите ниво на сигурност, като замените маркера JavaScript с адаптер от страна на сървъра, или да комбинирате гъвкавостта на адаптера JavaScript с хибридния модел за сигурност, описан в тази страница; и двата метода са сигурни.

Един ред код

За да добавите адаптера от страна на клиента към сайта си, просто добавете следния един ред код в <head> на вашите страници:

Добавете нашата виртуална чакалня към сайта си с този единствен ред код и предотвратете сривове на сайта

Някои клиенти добавят думата defer към тага, което кара скрипта на адаптера да бъде изтеглен паралелно с анализа на страницата и да започне изпълнението на скрипта в браузъра на посетителя едва след като страницата е завършила анализа (обикновено след като са завършени всички други скриптове на страницата).

Добавянето на думата defer (отлагане) може да подобри времето до първата снимка с малка част от секундата в някои случаи, но ако решите да го направите, това ще означава, че всички посетители, които трябва да бъдат поставени на опашка, ще видят защитената ви страница за част от секундата по-дълго, преди да бъдат изпратени на опашката.

Google Tag Manager

Предоставяме и адаптерния таг на JavaScript чрез Google Tag Manager. Потърсете Queue-Fair в Галерията с шаблони на общността, в раздел Добавяне на таг. Моля, обърнете внимание, че някои рекламни блокери предотвратяват изтеглянето на главния файл gtm.js от Google, което блокира всички операции на Google Tag Manager, включително стартирането на адаптера за тези посетители.Нашият таг за виртуална чакалня за Google Tag Manager

Хранилища на GitHub

Google Tag Manager

Google Tag Manager

Хранилището на GitHub за виртуалната чакалня Queue-Fair Google Tag Manager Client-Side Adapter Tag.

Страници с динамични опашки

Всички данни, които желаете, могат да бъдат предадени от вашия сайт към нашите сървъри и към страниците на опашката, които посетителите ви виждат, като използвате атрибута data-queue-fair-extra, който е наличен в клиентския JavaScript таг и в имплементацията на Google Tag Manager. Моля, свържете се с отдела за поддръжка, ако желаете да активирате динамични страници в опашката във Вашия акаунт.

Можете да използвате тази функция, за да персонализирате страниците на опашката в движение. Можете също така да използвате Queue-Fair, за да предадете данните, които ни изпращате заедно с посетителите си, обратно на сайта си, когато те преминават през опашката, за допълнително ниво на сигурност.

Предоставяме също така API за динамични страници на опашки, който използва допълнителните данни за персонализиране на всеки аспект на страница на опашка, така че можете да създадете една опашка за целия си сайт и да я персонализирате автоматично за различни събития или продукти на сайта си, без да се налага да правите каквито и да било промени в страниците на опашки в портала Queue-Fair.



Shopify, Wordpress и WooCommerce

Ако използвате сайт, базиран на Wordpress, като например системата за пазаруване WooCommerce, можете лесно да добавите тага Client-Side JavasScript Adapter, като използвате плъгина Wordpress Insert Headers & Footers, без да се налага да променяте темите си или да пипате кода на Wordpress.

Просто изтеглете плъгина Insert Headers & Footers, разархивирайте го в папката си /wp-content/plugins/, активирайте плъгина в менюто Plugins, отворете плъгина от менюто Settings, добавете тага към Scripts in Header, както е показано, натиснете Save в долната част на страницата и сте готови!

Shopify е също толкова лесно - тук са инструкциите за добавяне на клиентския адаптер на Queue-Fair за JavaScript към вашия магазин Shopify.

Информационното табло на портала Queue-Fair

Адаптер от страната на клиента Допълнителни ресурси

Адаптерът от страна на клиента е описан подробно в Техническото ръководство. Техническото ръководство е налично в портала Queue-Fair > раздел Помощ или можете да поискате копие от нас.


Адаптери от страна на сървъра

Докато адаптерът от страна на клиента работи с JavaScript в браузърите на посетителите, адаптерите от страна на сървъра на Queue-Fair работят на вашия уеб сървър.

Адаптери за уеб сървър

Това означава, че уеб сървърът ви може да се възползва от допълнителни функции за сигурност, за да откаже достъп на хора, които не са били поставени на опашка. Това също така означава, че уеб сървърът ви избягва натоварването, свързано с генерирането и обслужването на страници, съдържащи скрипт Adapter.

Добавянето на библиотеките на Queue-Fair Server-Side Adapter отнема само няколко минути с минимални промени в кода, за да се активира и стартира адаптерът.

Повечето от нашите клиенти започват с JavaScript адаптера от страна на клиента и преминават към адаптера от страна на сървъра само при конкретна бизнес необходимост.

Прост и безопасен режим

Адаптерите от страната на сървъра Queue-Fair могат да работят в обикновен или безопасен режим.

В обикновен режим всички посетители се изпращат към сървърите Queue-Fair, за да бъдат преброени, независимо дали е създадена опашка. Когато няма опашка, те се връщат веднага на вашия уеб сървър, без да виждат страница с опашка - но с подписа, от който се нуждае вашият уеб сървър, за да гарантира, че само хората, които са били пропуснати от опашката, имат достъп до вашите защитени ресурси.

В безопасен режим посетителите се изпращат към сървърите Queue-Fair само когато има опашка. Вашият уеб сървър се консултира директно с нашите сървъри за опашки, за да определи това. Посетителите продължават да са сигурно цифрово подписани, независимо дали е показана страница с опашка или не.

Безопасният режим се препоръчва за ежедневни опашки. Обикновеният режим е подходящ за времеви събития, когато очаквате хиляди хора, тъй като премахва закъснението, дължащо се на проверката на повикването от вашия уеб сървър към нашите сървъри за опашки, което означава, че можете да изпращате хора на опашката по-ефективно.

Хранилища на GitHub

Адаптер за виртуална чакалня на PHP') ?>

PHP

Хранилището на GitHub за адаптера от страна на сървъра на Queue-Fair Virtual Waiting Room на PHP.

Адаптер за виртуална чакалня на Java

Java

Хранилището на GitHub за адаптера Queue-Fair Virtual Waiting Room от страна на сървъра за Java, включително JBoss и Tomcat.

Адаптер за виртуална чакалня Ruby

Ruby

Хранилището на GitHub за адаптера от страна на сървъра на виртуалната чакалня Queue-Fair в Ruby и (по избор) Rails.

Адаптер за виртуална чакалня на Python

Python

Хранилището в GitHub за адаптера от страна на сървъра на виртуалната чакалня Queue-Fair в Python и (по избор) Django.

Адаптер за виртуална чакалня на dotNet

.NET

Хранилището на GitHub за виртуалната чакалня Queue-Fair Server-Side Adapter за .NET, ASP и C#.

Адаптер за виртуална чакалня на Node.js и JavaScript

Node.js & JavaScript

Хранилището в GitHub за адаптера от страна на сървъра Queue-Fair Virtual Waiting Room за Node.js и (по избор) Express.



Страници с динамични опашки

Както и при адаптера от страна на клиента, всички данни, които желаете, могат да бъдат предадени от вашия уеб сървър на нашите сървъри и на страниците в опашката, които посетителите ви виждат, като предадете тази информация в извикването на адаптера от страна на сървъра. Това улеснява динамичното персонализиране на страници на опашката или други настройки в движение по същия начин - всички функции на Client-Side Adapter се поддържат напълно. Моля, свържете се с поддръжката, ако желаете да активирате Dynamic Queue Pages (Динамични страници на опашката) в акаунта си.

Допълнителни ресурси за адаптера от страна на сървъра

Нашите адаптери от страна на сървъра са описани подробно в Техническото ръководство. Техническото ръководство е достъпно в портала Queue-Fair > раздел Помощ или можете да поискате копие от нас. Можете също така да намерите повече информация за всеки от адаптерите в README.md на всяко хранилище в GitHub.


Мрежови крайни адаптери

Мрежовите адаптери на Queue-Fair се изпълняват в рамките на вашия доставчик на CDN или облачни услуги, а не в браузърите на посетителите или на вашия сървър за произход.

Адаптери за Lambda и CDN доставчик

Това осигурява същата сигурност като адаптера от страна на сървъра и същата защита от натоварване като директната връзка.

Добавянето на библиотеките на мрежовия адаптер Queue-Fair Network-Edge Adapter отнема само няколко минути с минимални промени в кода на вашия доставчик на облачни услуги, за да се активира и стартира адаптерът, който обикновено се внедрява като функция Lambda или Edge Worker.

Прост и безопасен режим

Както и при нашите адаптери от страна на сървъра, нашите мрежови адаптери могат да работят в обикновен или безопасен режим.

Налични адаптери

Адаптер за виртуална чакалня на Amazon AWS CloudFront Network-Edge') ?>

CloudFront

Адаптер за виртуална чакалня на Amazon AWS CloudFront Network-Edge.

Адаптер за виртуална чакалня на Cloudflare Network-Edge

Cloudflare

Адаптер за виртуална чакалня на Cloudflare Network-Edge

Адаптер за виртуална чакалня Fastly Network-Edge

Fastly

Адаптер за виртуална чакалня Fastly Network-Edge..

Адаптер за виртуална чакалня на Akamai Network-Edge

Akamai

Адаптер за виртуална чакалня на Akamai Network-Edge.



Страници с динамични опашки

Както и при адаптера от страна на клиента, всички данни, които желаете, могат да бъдат предадени от вашия сайт на нашите сървъри и на страниците в опашката, които посетителите ви виждат, като предадете тази информация в извикването на адаптера. Това улеснява динамичното персонализиране на страници на опашката или други настройки в движение по същия начин - всички функции на адаптера от страната на клиента се поддържат напълно. Моля, свържете се с поддръжката, ако желаете да активирате функцията Dynamic Queue Pages (Динамични страници на опашката) в акаунта си.

Допълнителни ресурси за мрежовия адаптер

Нашите мрежови адаптери са подробно описани в Техническото ръководство. Техническото ръководство е достъпно в портала Queue-Fair > раздел Помощ или можете да поискате копие от нас. Можете също така да намерите повече информация за всеки от адаптерите в README.md на всяко хранилище в GitHub.


REST APIs

Queue-Fair предоставя на разработчиците достъп до шест модула REST API. За да използвате API, ще ви е необходим акаунт в Queue-Fair. За да разрешите достъпа до API за вашия акаунт, моля, свържете се с отдела за поддръжка на Queue-Fair. Нашите REST API модули отговарят на стандартите OpenAPI, RFC 7807 и RFC 3339.

Нашият набор от API модули е всеобхватен - всичко, което можете да правите в портала, можете да правите и с API, с изключение на управлението на потребителите на портала, което е изключено от съображения за поверителност.

Всеки API модул е напълно документиран на api.queue-fair.net, където ще намерите и Swagger интерфейс за по-лесна употреба и тестване. За сигурност всички API повиквания са защитени чрез сигурно TLS криптиране и изискват API ключ, който е специфичен за вашия акаунт.

Модули на API

API за отчитане

За отчети в реално време, исторически отчети и обобщени статистически данни за опашките.

API за управление на опашки

За програмно създаване и промяна на опашки в реално време.

API за управление на акаунти

За преглед и актуализиране на настройките на акаунта.

API за управление на активи

За управление на активите, използвани от вашите страници в опашката, обслужвани от Google CDN.

API за представяне

За промяна на всеки аспект на HTML на страниците на опашката и за актуализиране и създаване на варианти в движение.

API за активиране

За конфигуриране на правилата за активиране, които определят кои страници на сайта ви могат да задействат опашка и коя страница се показва.



Страници с динамични опашки

Можете също така да променяте своите страници с опашки в движение, без да се налага да актуализирате базата данни, като използвате API на портала или на презентацията - свържете се с поддръжката за повече подробности и за активиране на динамичните страници с опашки във вашия акаунт.

REST API Допълнителни ресурси

Както се изисква от RFC 7807, можете да намерите документация за съобщенията за грешки, които могат да бъдат върнати от нашите REST API модули, на адрес queue-fair.com/api-error


Родни приложения

Queue-Fair изглежда чудесно както на мобилни браузъри, така и на настолни компютри и лаптопи.

Можете също така да използвате Queue-Fair директно в родните си приложения за iOS и Android, както и в React Native приложенията за iOS, Android, Windows и MacOS, за да защитите дейности или операции, изискващи много ресурси.

Адаптерите за приложения Queue-Fair използват WebClient, за да показват на потребителите персонализирани дисплеи на опашки, когато услугите ви са твърде заети, с гъвкавостта и лекотата на използване на Queue-Fair Portal.

Можете да подредите потребителите в същата опашка като посетителите на уебсайта си или да създадете отделна опашка за потребителите на приложенията си - това зависи от вас.

Подобно на нашите уеб-базирани опашки, мястото на всеки потребител се запазва автоматично, ако той напусне приложението ви.

Хранилища на GitHub

Адаптер за виртуална чакалня на iOS, MacOS и Apple

iOS & MacOS

Хранилището на GitHub за адаптера за виртуална чакалня Queue-Fair за iOS и MacOS.

Адаптер за виртуална чакалня за Android

Android

Хранилището в GitHub за адаптера за виртуална чакалня Queue-Fair за Android.

Приложение за реактивна родна виртуална чакалня Адаптер

React Native

Хранилището в GitHub за адаптера Queue-Fair Virtual Waiting Room за React Native приложения за Android, iOS, MacOS и Windows.

Известия за опашка

Адаптерът Queue-Fair улеснява изпращането на Push известие до потребители, които не използват вашето приложение или опашка, когато им се обадят. Мястото на потребителя в опашката автоматично се съхранява постоянно от адаптера във вашето приложение. Ако потребителят се отклони от вашето приложение, приложението ви съобщава на вашия сървър за Push известия, че трябва да се изпрати известие, като изпраща съхранената информация за позицията в опашката като част от това съобщение до вашия сървър за Push известия.

Това е същата технология, която използваме за нашето потребителско приложение WeQ4U, което само в Обединеното кралство е изтеглено от около 2 милиона потребители.

Вашият сървър за известия Push периодично се консултира с API за състоянието на Queue-Fair, за да попита за позицията в опашката, която се обслужва в момента. Когато тя е по-голяма от позицията на опашката на даден потребител, е време да изпратите на този потребител известие. Ако потребителят се върне в опашката или е Passed (Преминал), преди да е изпратено Push известие, адаптерът уведомява вашето приложение, а вашето приложение съобщава на вашия сървър за Push известия, че известието вече не е необходимо.

Доколкото ни е известно, ние сме единственият доставчик на виртуална чакалня, който поддържа тази функция.

Видео ресурси

Ето видеоклип на адаптера за родни приложения в действие, който показва, че мястото на потребителя се запазва дори ако приложението е напълно спряно, и също така показва кукичките на адаптера, които вашето приложение използва за изпращане на известия Push.

Допълнителни ресурси

Нашите адаптери за родни приложения са описани в Техническото ръководство. Техническото ръководство е налично в портала Queue-Fair > раздел Помощ или можете да поискате копие от нас. Можете също така да намерите повече информация за всеки от адаптерите, която е специфична за iOS и Android, в README.md на всяко хранилище в GitHub.


Адаптери за електронна търговия

Queue-Fair може лесно да се добави към всяка система за електронна търговия с помощта на описания по-горе адаптер JavaScript от страна на клиента.

Предлагаме и адаптер за работа от страна на сървъра с много популярни сървъри за електронна търговия.

Хранилища на GitHub

Magento Plugin

Magento

Хранилището на GitHub за адаптера за виртуална чакалня Queue-Fair за Magento.

Адаптер за виртуална чакалня на WooCommerce/PHP

WooCommerce

Хранилището на GitHub за адаптера Queue-Fair Virtual Waiting Room за WooCommerce на PHP.

Адаптер за виртуална чакалня PrestaShop/PHP

PrestaShop

Хранилището на GitHub за адаптера за виртуална чакалня Queue-Fair за PrestaShop на PHP.

Допълнителни ресурси

Нашите адаптери са описани в Техническото ръководство. Техническото ръководство е достъпно в портала Queue-Fair > раздел Помощ или можете да поискате копие от нас.

Имаме и допълнителни ръководства за повечето платформи за електронна търговия - просто попитайте за желаното от вас.


Хибридна сигурност

Можете лесно да комбинирате гъвкавостта на адаптера JavaScript от страна на клиента с допълнителното ниво на сигурност, осигурено от нашия код от страна на сървъра.

Queue-Fair подписва всеки преминал посетител с цифров пръстов отпечатък, който е уникален за този посетител. Уникално за индустрията, подписът включва и код, специфичен за браузъра на посетителя, за да се предотврати споделянето на токени за достъп.

Вашият уеб сървър може да валидира подписа, като използва тайна, известна само на вас и на нас - не и на вашите посетители - за да гарантира, че всеки посетител е преминал справедливо през сървърите на Queue-Fair.

Така че можете да използвате адаптера JavaScript от страна на клиента, за да изпращате и получавате посетители към и от опашката и да проверявате за манипулации преди да са се наредили с минимален код от страна на сървъра и да избегнете въвеждането на зависимост от нашата система.

В нашите хранилища в GitHub са включени примерни кодове на всички основни езици за уеб програмиране.

Хранилища на GitHub

PHP

PHP

Хранилището на GitHub за адаптера от страна на сървъра на Queue-Fair Virtual Waiting Room на PHP.

Java

Java

Хранилището на GitHub за адаптера Queue-Fair Virtual Waiting Room от страна на сървъра за Java, включително JBoss и Tomcat.

Ruby

Ruby

Хранилището в GitHub за адаптера от страна на сървъра на Queue-Fair Virtual Waiting Room в Ruby и (по избор) Rails.

Python

Python

Хранилището в GitHub за адаптера от страна на сървъра на виртуалната чакалня Queue-Fair в Python и (по избор) Django.

.NET

.NET

Хранилището на GitHub за виртуалната чакалня Queue-Fair Server-Side Adapter за .NET, ASP и C#.

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

Node.js & JavaScript

Хранилището в GitHub за адаптера от страна на сървъра Queue-Fair Virtual Waiting Room за Node.js и (по избор) Express.

Допълнителни ресурси

Хибридният модел за сигурност е описан подробно в Техническото ръководство. Техническото ръководство е достъпно в портала Queue-Fair > раздел Помощ или можете да поискате копие от нас.


Лиценз

Публикуваният от нас код, достъпен в хранилището на GitHub Queue-Fair, е лицензиран с лиценза MIT, който е сред най-разрешителните лицензи за отворен код.


Искате ли да знаете как работи Queue-Fair?