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



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

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

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

Нуждаете се от помощ за настройване на тарифите за вашата опашка? Всичко, което трябва да знаете, е тук.

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

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

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

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

Един ред код

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

глобалната общност изключва данъка сортиране прецизиране на цената на системата за чакане на опашки за плъгини на WordPress

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

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

Google Tag Manager

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

WordPress плъгини wp cron страхотен инструмент за търсене на wordpress и публикации в общността на сайта на страхотна цена

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

Wordpress задачи плъгин имот за създаване на данни долари не се изисква php

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



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

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

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

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

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



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

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

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

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

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

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

Адаптерът 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

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

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

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


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

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

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

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

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

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

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

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

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


Лиценз

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


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