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

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, WooCommerce и Wordpress

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

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

Някои клиенти на Wordpress обичат да добавят тага Queue-Fair JavaScript и към своите страници за грешки в Wordpress, което можете да направите, като редактирате файла /wp-includes/functions.php - добавете го към HTML, съдържащ се във функцията _default_wp_die_handler в този файл.

Shopify е също толкова лесно - тук са инструкциите за добавяне на Queue-Fair Client-Side JavaScript Adapter към вашия магазин Shopify - използвайте трите точки в горния ляв ъгъл, след като натиснете Customise, за да редактирате кода на вашия файл theme.liquid Layout.

Виртуална чакалня на SquareSpace от страна на клиента

Адаптерът за JavaScript от страна на клиента също така се добавя много лесно към вашия сайт в SquareSpace - влезте в системата и изберете своя уебсайт, след това Website (Уебсайт) от лявата навигационна лента, Website Tools (Инструменти за уебсайта) (в раздела Utilities (Помощни средства) в лявата навигационна лента), Code Injection (Инжектиране на код) и след това го копирайте и поставете в полето Header (Заглавие), след което Save (Запазване) в горния ляв ъгъл.

За максимална сигурност в SquareSpace използвайте нашия адаптер за SquareSpace Network-Edge Adapter, описан по-долу.

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

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

Докато адаптерът от страна на клиента работи с JavaScript в браузърите на посетителите, адаптерите от страна на сървъра на Queue-Fair работят на вашия уеб сървър.Това означава, че сървърите ви могат да изпращат посетители към опашката по-ефективно. Лошите играчи няма да виждат съдържание от сайта ви, но ботовете все още могат да правят заявки към сървърите ви, така че за пълна DDoS защита използвайте един от нашите мрежови адаптери по-долу.

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

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

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

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

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

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

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

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

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

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

PHP

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

Java

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

Ruby

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

Python

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

.NET

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

Node.js

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

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

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

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

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

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

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

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

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

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

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

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

Cloudfront

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

Cloudflare

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

Fastly

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

Akamai

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

Azure

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

Google Cloud

Адаптер за виртуална чакалня на ниво мрежа на Google Cloud.

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

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

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

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

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 на портала или на презентацията - свържете се с поддръжката за повече подробности и за активиране на динамичните страници с опашки във вашия акаунт.

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

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

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

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

WooCommerce

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

SquareSpace

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

PrestaShop

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

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

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

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

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

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

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

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

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

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

PHP

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

Java

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

Ruby

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

Python

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

.NET

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

Node.js

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

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

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

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