Resurse pentru dezvoltatori



Adăugarea Queue-Fair

Sala de așteptare virtuală Queue-Fair este ușor de adăugat la o mare varietate de platforme web și aplicații în câteva minute. Trebuie doar să utilizați unul dintre adaptoarele noastre. Puteți găsi mai multe informații despre cea mai bună modalitate de a integra serviciul Queue-Fair cu sistemul dvs. existent în Ghidul tehnic sau în secțiunea Queue-Fair Portal > Ajutor. Dacă sunteți în căutarea de informații despre cum să împiedicați roboții sau oamenii să facă comenzi multiple sau cum să vă protejați vânzările NFT de comisioanele excesive de gaz, puteți citi această prezentare generală sau puteți obține detalii complete în secțiunea Ghid de securitate din Portal.

Cel mai rapid mod de a începe cu Queue-Fair este să vă înscrieți pentru un abonament Nivel gratuit cont - puteți face acest lucru online acum și puteți începe să integrați și să testați imediat.

Aveți nevoie de ajutor cu privire la stabilirea tarifelor pentru coada dvs. de așteptare? Tot ce trebuie să știți este aici.

Adaptorul din partea clientului

Pentru site-urile web, cel mai simplu mod de integrare cu Queue-Fair este de a adăuga tag-ul Client-Side Queue-Fair Adapter JavaScript în paginile dvs. Puteți adăuga în siguranță adaptorul la toate paginile de pe site-ul dvs. și puteți utiliza regulile de activare din portalul Queue-Fair pentru a determina ce pagini pot genera o coadă de așteptare.

Adaptorul nostru JavaScript Client-Side Adapter este mai sigur decât piesele de integrare pe partea clientului de la alți furnizori. Deoarece rulează în browserele vizitatorilor dvs., adaptorul pentru partea de client poate fi modificat de către vizitatorii cu abilități tehnice, dar este foarte eficient în prevenirea supraîncărcării, deoarece doar o minoritate foarte mică de persoane va încerca să sară peste coada de așteptare prin modificarea JavaScript. Majoritatea clienților noștri folosesc Client-Side Adapter pentru că este eficient în prevenirea blocării site-ului, este simplu de instalat și nu introduce nicio dependență între sistemul nostru și al dumneavoastră. Spre deosebire de piesele de integrare pe partea clientului de la alți furnizori, acesta poate fi făcut inviolabil cu ajutorul modelului de securitate hibrid descris în Ghidul tehnic.

Puteți adăuga un nivel de securitate înlocuind eticheta JavaScript cu un adaptor de partea serverului sau puteți combina flexibilitatea adaptorului JavaScript cu modelul de securitate hibrid descris pe această pagină; ambele metode sunt sigure.

O singură linie de cod

Pentru a adăuga adaptorul pentru partea de client la site-ul dvs., adăugați următoarea linie de cod la fișierul <head> secțiune a paginilor dvs.:

comunitatea globală exclude impozitul sortare rafinați prețul sistemului de coadă pentru plugin-urile wordpress

Unii clienți adaugă cuvântul defer la etichetă, ceea ce face ca scriptul Adapter să fie descărcat în paralel cu analiza paginii și, de asemenea, să înceapă executarea scriptului în browserul vizitatorului numai după ce pagina a terminat analiza (deci, de obicei, după ce orice alt script de pe pagina dvs. a fost terminat).

Adăugarea cuvântului " amânare" poate îmbunătăți Timpul până la prima pictură cu o mică fracțiune de secundă în unele cazuri, dar dacă alegeți să faceți acest lucru, înseamnă că orice vizitator care ar trebui să fie pus în coadă va vedea pagina dvs. protejată pentru o fracțiune de secundă mai mult înainte de a fi trimis în coadă.

Google Tag Manager

De asemenea, punem la dispoziție JavaScript Adapter Tag prin intermediul Google Tag Manager. Căutați Queue-Fair în Galeria de șabloane comunitare, la rubrica Adaugă etichetă. Vă rugăm să rețineți că unele blocante de reclame împiedică descărcarea masterului gtm.js de la Google, ceea ce blochează toate operațiunile Google Tag Manager, inclusiv rularea sistemului de coadă Adaptor pentru acei vizitatori.

wordpress plugins wp cron mare instrument pentru wordpress căutare și site de comunitate posturi la un preț mare

Depozite GitHub

wordpress sarcini plugin proprietate pentru a crea date dolari nu este necesar php

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.

mărcile se alătură șabloanelor pentru controlul de apelare în fundal la fața locului

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.


Adaptoare de partea serverului

Î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



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.


Adaptoare de margine de rețea

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



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.


API-uri REST

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.


Aplicații native

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

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.


Adaptoare ECommerce

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

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.


Securitate hibridă

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

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.


Licență

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ă.


Doriți să știți cum funcționează Queue-Fair?