Resurse pentru dezvoltatori

Google Tag Manager

Depozitul GitHub pentru Queue-Fair Virtual Waiting Room Google Tag Manager Client-Side Adapter Tag.

Pagini de coadă dinamice

Orice date pe care le doriți pot fi transmise de pe site-ul dvs. către sistemul nostru de coadă și către paginile de coadă pe care le văd vizitatorii dvs., utilizând atributul data-queue-fair-extra, disponibil în eticheta JavaScript de pe partea clientului și în implementarea Google Tag Manager. Vă rugăm să contactați serviciul de asistență dacă doriți să activați Dynamic Queue Pages în contul dvs.

Puteți utiliza această funcție pentru a personaliza din mers paginile de coadă. De asemenea, puteți utiliza Queue-Fair pentru a transmite datele pe care ni le trimiteți împreună cu vizitatorii dvs. înapoi pe site-ul dvs. pe măsură ce aceștia sunt trecuți prin coadă, pentru un nivel suplimentar de securitate.

De asemenea, furnizăm un API dinamic pentru paginile de coadă care utilizează datele suplimentare pentru a personaliza orice aspect al unei pagini de coadă, astfel încât puteți crea o coadă pentru întregul site și o puteți personaliza automat pentru diferite evenimente sau produse de pe site, fără a fi nevoie să faceți modificări ale paginilor de coadă în portalul Queue-Fair

Shopify, WooCommerce & Wordpress gestionarea cozilor de așteptare

Dacă folosiți un site bazat pe Wordpress, cum ar fi sistemul de coș de cumpărături WooCommerce, puteți adăuga cu ușurință tag-ul Client-Side JavasScript Adapter folosind Plugin-ul Wordpress Insert Headers & Footers, fără a fi nevoie să modificați vreunul dintre temele sau șabloanele dvs. sau să atingeți vreun cod Wordpress.

Doar descărcați Plugin-ul Insert Headers & Footers, dezarhivați-l în folderul /wp-content/plugins/, activați plugin-ul în meniul Plugins, deschideți plugin-ul din meniul Settings, adăugați tag-ul la Scripts in Header așa cum se arată, apăsați Save în partea de jos a paginii și ați terminat! Gestionarea cozilor de așteptare din Wordpress simplificată. Există și alte plugin-uri Wordpress pe care le puteți folosi pentru a adăuga tag-ul - acesta este cel mai popular.

Unii clienți Wordpress preferă să adauge tag-ul Queue-Fair JavaScript și în paginile de eroare Wordpress, ceea ce se poate face prin editarea fișierului /wp-includes/functions.php - adăugați-l la HTML-ul conținut în funcția _default_wp_die_handler din acel fișier.

Shopify este la fel de ușor - aici sunt instrucțiuni pentru adăugarea adaptorului Queue-Fair Client-Side JavaScript Adapter la magazinul dvs. Shopify - folosiți cele trei puncte din stânga sus după ce ați apăsat pe Personalizare pentru a edita codul în fișierul dvs. theme.liquid Layout.

Sală de așteptare virtuală SquareSpace din partea clientului

Adaptorul Client-Side JavaScript Adapter este, de asemenea, foarte ușor de adăugat la site-ul SquareSpace - conectați-vă și selectați site-ul dvs. web, apoi Website din navigatorul din stânga, Website Tools (în secțiunea Utilități din navigatorul din stânga), Code Injection, apoi copiați și lipiți-l în caseta Header, apoi Save din stânga sus.

Pentru o securitate maximă în SquareSpace, utilizați adaptorul SquareSpace Network-Edge Adapter, descris mai jos.

Adaptor de partea clientului Resurse suplimentare

Adaptorul pentru partea client este descris pe larg în Ghidul tehnic. Ghidul tehnic este disponibil în portalul Queue-Fair > secțiunea Ajutor sau puteți solicita o copie de la noi.

În timp ce adaptorul de partea clientului rulează în JavaScript în browserele vizitatorilor dumneavoastră, adaptoarele Queue-Fair de partea serverului rulează pe serverul dumneavoastră web.Acest lucru înseamnă că serverele dvs. pot trimite vizitatorii la coadă mai eficient. Actorii răi nu vor vedea conținutul de pe site-ul dvs., însă roboții pot face în continuare cereri către serverele dvs., așa că, pentru o protecție DDoS completă, utilizați unul dintre adaptoarele noastre de rețea de mai jos.

Adaptoare pentru servere web

Acest lucru înseamnă că serverul dvs. web poate profita de caracteristicile de securitate suplimentare pentru a refuza accesul persoanelor care nu au fost puse în coadă. De asemenea, acest lucru înseamnă că serverul dvs. web evită sarcina generării și servirii paginilor care conțin scriptul Adapter.

Adăugarea bibliotecilor Queue-Fair Server-Side Adapter durează doar câteva minute, cu modificări minime ale codului pentru a activa și rula adaptorul.

Majoritatea clienților noștri încep cu adaptorul JavaScript pentru client și trec la adaptorul pentru server doar atunci când există o funcționalitate specifică sau o nevoie de afaceri.

Mod simplu și sigur

Adaptoarele Queue-Fair pentru server pot funcționa în modul simplu sau în modul sigur.

În modul simplu, toți vizitatorii sunt trimiși la serverele Queue-Fair pentru a fi numărați, indiferent dacă s-a format sau nu o coadă de așteptare. Atunci când există o coadă, aceștia se alătură acesteia. Când nu există o coadă, aceștia sunt returnați direct la serverul dvs. web, fără a vedea o pagină de coadă - dar cu semnătura de care serverul dvs. web are nevoie pentru a se asigura că numai persoanele care au fost trecute de coadă pot accesa resursele dvs. protejate.

În modul sigur, vizitatorii sunt trimiși la serverele Queue-Fair numai atunci când există o coadă de așteptare. Serverul dvs. web consultă direct serverele noastre de coadă în fundal pentru a face această determinare. Vizitatorii sunt în continuare semnate digital în siguranță, fie că se alătură unei cozi, fie că sunt trecuți fără a vedea o pagină de coadă de așteptare, deoarece coada este goală.

Safe Mode este recomandat pentru cozile de zi cu zi. Modul simplu este potrivit pentru un eveniment sau o vânzare cu timp, când așteptați mii de oameni, deoarece elimină latența datorată apelului de verificare de la serverul dvs. web la serverele noastre de coadă, ceea ce înseamnă că puteți trimite oamenii să se alăture cozii mai eficient.

Depozite GitHub

PHP

Depozitul GitHub pentru Queue-Fair Virtual Waiting Room Server-Side Adapter în PHP.

Java

Depozitul GitHub pentru Queue-Fair Virtual Waiting Room Server-Side Adapter pentru Java, inclusiv JBoss și Tomcat.

Ruby

Depozitul GitHub pentru Queue-Fair Virtual Waiting Room Server-Side Adapter în Ruby și (opțional) Rails.

Python

Depozitul GitHub pentru Queue-Fair Virtual Waiting Room Server-Side Adapter în Python și (opțional) Django.

.NET

Depozitul GitHub pentru Queue-Fair Virtual Waiting Room Server-Side Adapter pentru .NET, ASP și C#.

Node.js & JavaScript

Depozitul GitHub pentru Queue-Fair Virtual Waiting Room Server-Side Adapter pentru Node.js și (opțional) Express.

Pagini de coadă dinamice

La fel ca în cazul adaptorului pentru partea de client, orice date pe care le doriți pot fi transmise de la serverul dvs. web la serverele noastre și la paginile de coadă pe care le văd vizitatorii dvs. prin transmiterea acestor informații în apelul adaptorului pentru partea de server pe măsură ce oamenii se alătură cozii. Acest lucru facilitează pagina de coadă dinamică sau orice altă personalizare din mers în același mod - toate caracteristicile adaptorului de partea clientului sunt pe deplin acceptate. Vă rugăm să contactați serviciul de asistență dacă doriți să activați Dynamic Queue Pages în contul dumneavoastră.

Adaptor de partea serverului Resurse suplimentare

Adaptoarele noastre pentru partea de server sunt descrise pe larg în Ghidul tehnic. Ghidul tehnic este disponibil în portalul Queue-Fair > secțiunea Ajutor sau puteți solicita o copie de la noi. De asemenea, puteți găsi mai multe informații despre fiecare dintre adaptoare în fișierul README.md al fiecărui depozit global al comunității GitHub.

Adaptoarele Queue-Fair Network-Edge Adapters rulează în cadrul CDN sau al furnizorului de servicii cloud, mai degrabă decât în browserele vizitatorilor sau pe serverul dvs. de origine. Acesta este cel mai bun mod de a utiliza Queue-Fair pentru a vă proteja serverele de atacurile bot, inclusiv de atacurile DDoS.

Adaptoare pentru furnizorii Lambda și CDN

Aceasta oferă aceeași funcționalitate și securitate ca și adaptorul de server și aceeași protecție a sarcinii ca și Direct Link.

Adăugarea bibliotecilor Queue-Fair Network-Edge Adapter durează doar câteva minute cu modificări minime de cod la furnizorul de cloud pentru a activa și rula adaptorul, care este în mod normal implementat ca o funcție Lambda sau Edge Worker.

Mod simplu și sigur

La fel ca și în cazul adaptoarelor noastre pentru partea de server, adaptoarele noastre pentru partea de rețea pot funcționa în modul simplu sau sigur.

Adaptoare disponibile

CloudFront

Adaptor pentru sala de așteptare virtuală Amazon AWS CloudFront Network-Edge.

Cloudflare

Cloudflare Adaptor pentru sala de așteptare virtuală în jurul rețelei Cloudflare

Fastly

Adaptor pentru sala de așteptare virtuală Fastly Network-Edge..

Akamai

Akamai Network-Edge Virtual Waiting Room Adapter.

Pagini de coadă dinamice

La fel ca în cazul adaptorului pentru partea de client, orice date pe care le doriți pot fi transmise de la site-ul dvs. la serverele noastre și la paginile de așteptare pe care le văd vizitatorii dvs., prin transmiterea acestor informații în apelul adaptorului. Acest lucru facilitează pagina de coadă dinamică sau alte tipuri de personalizare din mers, pe măsură ce oamenii se alătură cozii în același mod - toate caracteristicile adaptorului pentru partea de client sunt pe deplin acceptate. Vă rugăm să contactați serviciul de asistență dacă doriți să activați Pagini dinamice de coadă în contul dvs.

Adaptor de margine de rețea Resurse suplimentare

Adaptoarele noastre de rețea sunt descrise pe larg în Ghidul tehnic. Ghidul tehnic este disponibil în portalul Queue-Fair > secțiunea Ajutor, sau puteți solicita o copie de la noi. De asemenea, puteți găsi mai multe informații despre fiecare dintre adaptoare în fișierul README.md al fiecărui depozit global al comunității GitHub.

Queue-Fair oferă dezvoltatorilor acces la șase module API REST. Aveți nevoie de un cont Queue-Fair pentru a utiliza API. Pentru a activa accesul la API pentru contul dvs., vă rugăm să contactați Queue-Fair Support. Modulele noastre REST API sunt conforme cu standardele OpenAPI, RFC 7807 și RFC 3339.

Suita noastră de module API este cuprinzătoare - tot ceea ce puteți face în portal, puteți face și cu API, cu excepția gestionării utilizatorilor portalului, care este exclusă din motive de confidențialitate.

Fiecare modul API este complet documentat la api.queue-fair.net, unde veți găsi, de asemenea, o interfață Swagger pentru a facilita utilizarea și testarea. Pentru securitate, toate apelurile API sunt protejate prin criptare securizată TLS și necesită o cheie API specifică contului dvs.

Module API

Pagini de coadă dinamice

De asemenea, puteți modifica paginile de coadă din mers, fără a fi nevoie să actualizați baza de date, utilizând Portalul sau API-ul de prezentare - Contactați serviciul de asistență pentru mai multe detalii și pentru a activa paginile de coadă dinamice în contul dumneavoastră.

REST API Resurse suplimentare

Conform cerințelor RFC 7807, puteți găsi documentația despre mesajele de eroare care pot fi returnate de modulele noastre REST API la queue-fair.com/api-error.

Queue-Fair arată foarte bine atât pe browserele mobile, cât și pe desktopuri și laptopuri.

De asemenea, puteți utiliza Queue-Fair direct în aplicațiile native pentru iOS și Android, precum și în aplicațiile React Native pe iOS, Android, Windows și MacOS, pentru a proteja activitățile sau operațiunile care necesită multe resurse.

Adaptoarele de aplicații Queue-Fair utilizează un client Web pentru a conecta aplicațiile și a afișa afișaje personalizate ale cozilor de așteptare pentru utilizatorii dvs. atunci când serviciile dvs. sunt prea ocupate, cu flexibilitatea și ușurința de utilizare ale Queue-Fair Portal.

Puteți să puneți utilizatorii în aceeași coadă ca și vizitatorii site-ului dvs. web sau să creați o coadă separată pentru utilizatorii aplicației dvs. - depinde de dvs.

La fel ca și în cazul cozilor de așteptare bazate pe web, odată ce s-au alăturat cozii, locul fiecărui utilizator este salvat automat și în cazul în care acesta părăsește aplicația.

Depozite GitHub

iOS & MacOS

Depozitul GitHub pentru adaptorul pentru sala de așteptare virtuală Queue-Fair pentru iOS și MacOS.

Android

Depozitul GitHub pentru adaptorul pentru sala de așteptare virtuală Queue-Fair pentru Android.

React Native

Depozitul GitHub pentru adaptorul pentru sala de așteptare virtuală Queue-Fair pentru aplicațiile React Native pentru Android, iOS, MacOS și Windows.

Notificări de coadă

Adaptorul Queue-Fair dispune de callback-uri care facilitează trimiterea de notificări push către utilizatorii care nu utilizează aplicația sau coada de așteptare atunci când le vine rândul. Locul utilizatorului în coada de așteptare este stocat automat și persistent de către adaptor în aplicația dvs. Dacă utilizatorul navighează în afara aplicației dvs., aplicația dvs. îi spune serverului de notificare Push că trebuie trimisă o notificare, trimițând informațiile privind poziția stocată în coadă ca parte a acelui mesaj către serverul de notificare Push.

Este aceeași tehnologie pe care o folosim pentru aplicația și serviciul nostru pentru consumatori WeQ4U, care a fost descărcat de aproximativ 2 milioane de ori numai în Marea Britanie.

Serverul dvs. de notificări push consultă periodic Queue-Fair Status API pentru a interoga poziția cozii de așteptare care este servită în prezent. Atunci când aceasta este mai mare decât poziția în coadă a unui anumit utilizator, este momentul să contactați acel utilizator cu notificarea. Dacă utilizatorul se întoarce în coadă sau este trecut înainte de a fi trimisă o notificare Push Notification, callback-urile din adaptor notifică aplicația dvs., iar aplicația dvs. îi spune serverului Push Notification că notificarea nu mai este necesară.

Din câte știm noi, suntem singurul furnizor de săli de așteptare virtuale care acceptă această funcție.

Resurse video

Iată un videoclip cu adaptorul pentru aplicații native în acțiune, care arată că locul utilizatorului este salvat chiar dacă aplicația este complet oprită și, de asemenea, arată cârligele adaptorului pe care aplicația dvs. le utilizează pentru a trimite notificări push.

Resurse suplimentare

Adaptoarele noastre native pentru aplicații sunt descrise în Ghidul tehnic. Ghidul tehnic este disponibil în portalul Queue-Fair > secțiunea Ajutor, sau puteți solicita o copie de la noi. De asemenea, puteți găsi mai multe informații despre fiecare dintre adaptoare, care sunt specifice pentru iOS și Android, în README.md din fiecare depozit global al comunității GitHub.

Queue-Fair poate fi adăugat cu ușurință la orice sistem de comerț electronic folosind adaptorul JavaScript pe partea clientului descris mai sus.

Oferim, de asemenea, cod adaptor pentru a lucra pe partea de server cu multe servere populare de comerț electronic.

Depozite GitHub

Magento

Depozitul GitHub pentru Queue-Fair Virtual Waiting Room Adapter pentru Magento.

WooCommerce

Depozitul GitHub pentru Queue-Fair Virtual Waiting Room Adapter pentru WooCommerce în PHP.

PrestaShop

Depozitul GitHub pentru Queue-Fair Virtual Waiting Room Adapter pentru PrestaShop în PHP.

SquareSpace

Depozitul GitHub pentru adaptorul pentru sala de așteptare virtuală Queue-Fair pentru SquareSpace.

Resurse suplimentare

Adaptoarele noastre sunt descrise în Ghidul tehnic. Ghidul tehnic este disponibil în portalul Queue-Fair > secțiunea Ajutor, sau puteți solicita o copie de la noi.

Avem, de asemenea, ghiduri suplimentare disponibile pentru majoritatea platformelor de comerț electronic - cereți-le doar pe cele pe care le doriți.

Puteți combina cu ușurință flexibilitatea adaptorului JavaScript din partea clientului cu stratul suplimentar de securitate oferit de codul nostru din partea serverului.

Queue-Fair semnează fiecare vizitator pe care îl trecem cu o amprentă digitală care este unică pentru acel vizitator. În mod unic în industrie, semnătura include, de asemenea, un cod specific browserului vizitatorului, pentru a preveni partajarea token-urilor de acces.

Serverul dvs. web poate valida semnătura folosind un secret cunoscut doar de dvs. și de noi - nu și de vizitatorii dvs. - pentru a se asigura că fiecare vizitator a trecut în mod corect prin serverele Queue-Fair.

Astfel, puteți utiliza adaptorul JavaScript din partea clientului pentru a trimite și a primi vizitatori în și din coadă și pentru a verifica dacă au fost manipulați înainte de a comanda, cu un cod minim de cod din partea serverului, evitând introducerea unei dependențe de sistemul nostru.

Exemple de cod sunt incluse în depozitele noastre GitHub din comunitatea globală în fiecare limbaj de programare web important.

Depozite GitHub

PHP

Depozitul GitHub pentru Queue-Fair Virtual Waiting Room Server-Side Adapter în PHP.

Java

Depozitul GitHub pentru Queue-Fair Virtual Waiting Room Server-Side Adapter pentru Java, inclusiv JBoss și Tomcat.

Ruby

Depozitul GitHub pentru Queue-Fair Virtual Waiting Room Server-Side Adapter în Ruby și (opțional) Rails.

Python

Depozitul GitHub pentru Queue-Fair Virtual Waiting Room Server-Side Adapter în Python și (opțional) Django.

.NET

Depozitul GitHub pentru Queue-Fair Virtual Waiting Room Server-Side Adapter pentru .NET, ASP și C#.

Node.js & JavaScript

Depozitul GitHub pentru Queue-Fair Virtual Waiting Room Server-Side Adapter pentru Node.js și (opțional) Express.

Resurse suplimentare

Modelul de securitate hibrid este descris pe larg în Ghidul tehnic. Ghidul tehnic este disponibil în portalul Queue-Fair > secțiunea Ajutor, sau puteți solicita o copie de la noi.

Codul nostru publicat, disponibil la GitHub Queue-Fair Repository, este licențiat sub licența MIT, care este una dintre cele mai permisive licențe Open Source pentru comunitatea globală.