Ressources pour les développeurs



Ajout de Queue-Fair

La salle d'attente virtuelle Queue-Fair s'ajoute facilement à une grande variété de plateformes web et d'applications en quelques minutes. Il suffit d'utiliser l'un de nos adaptateurs. Vous trouverez plus d'informations sur la meilleure façon d'intégrer le service Queue-Fair à votre système existant dans le Guide technique ou dans la section Aide du portail Queue-Fair. Si vous cherchez des informations sur la manière d'empêcher les robots ou les humains de passer des ordres multiples, ou de protéger vos ventes NFT contre des frais de gaz excessifs, vous pouvez lire cet aperçu ou obtenir tous les détails dans la section Guide de sécurité du portail.

La façon la plus rapide de commencer à utiliser Queue-Fair est de s'inscrire pour obtenir un compte. Niveau gratuit Vous pouvez le faire en ligne dès maintenant et commencer à intégrer et à tester immédiatement.

L'adaptateur côté client

Pour les sites Web, le moyen le plus simple d'intégrer Queue-Fair est d'ajouter la balise JavaScript Client-Side Queue-Fair Adapter à vos pages. Vous pouvez ajouter l'adaptateur à toutes les pages de votre site en toute sécurité et utiliser les règles d'activation du portail Queue-Fair pour déterminer quelles pages peuvent lancer une file d'attente.

Parce qu'il s'exécute dans le navigateur de vos visiteurs, l'adaptateur côté client peut être désactivé par des visiteurs techniquement compétents, mais il est très efficace pour prévenir la surcharge, car seule une très petite minorité de personnes tentera de sauter la file d'attente en manipulant le JavaScript. La plupart de nos clients utilisent l'adaptateur côté client parce qu'il est efficace pour éviter un plantage du site, qu'il est simple à installer et qu'il n'introduit aucune dépendance entre notre système et le vôtre.

Vous pouvez ajouter une couche de sécurité en remplaçant la balise JavaScript par un adaptateur côté serveur, ou combiner la souplesse de l'adaptateur JavaScript avec le modèle de sécurité hybride décrit sur cette page ; les deux méthodes sont alors sécurisées.

Une seule ligne de code

Pour ajouter l'adaptateur côté client à votre site, il suffit d'ajouter la ligne de code suivante au fichier <head> de vos pages:

la communauté mondiale exclut la taxe tri affiner le prix du système de file d'attente pour les plugins wordpress

Certains clients ajoutent le mot defer à la balise, ce qui a pour effet de télécharger le script de l'adaptateur parallèlement à l'analyse syntaxique de la page et de ne lancer l'exécution du script dans le navigateur du visiteur qu'une fois l'analyse syntaxique de la page terminée (donc généralement après la fin de tous les autres scripts de votre page).

L'ajout du mot " defer" peut améliorer le temps de la première peinture d'une petite fraction de seconde dans certains cas, mais si vous choisissez de le faire, cela signifie que tous les visiteurs qui devraient être mis en file d'attente verront votre page protégée pendant une fraction de seconde de plus avant d'être envoyés dans la file d'attente.

Gestionnaire de balises Google

Nous fournissons également le JavaScript Adapter Tag via Google Tag Manager. Recherchez Queue-Fair dans la galerie des modèles communautaires, sous Ajouter un tag. Veuillez noter que certains bloqueurs de publicité empêchent le téléchargement du master gtm.js de Google, ce qui bloque toutes les opérations de Google Tag Manager, y compris l'exécution du système de file d'attente Adapter pour ces visiteurs.

wordpress plugins wp cron grand outil pour la recherche wordpress et les postes de la communauté du site à un grand prix

Dépôts GitHub

wordpress tâches plugin propriété pour créer des dollars de données pas de php requis

Gestionnaire de balises Google

Le dépôt GitHub pour la balise Salle d'attente virtuelle Queue-Fair Google Tag Manager Client-Side Adapter Tag.

Pages de file d'attente dynamique

Toutes les données que vous souhaitez peuvent être transmises de votre site à notre système de file d'attente et aux pages de file d'attente que vos visiteurs voient en utilisant l'attribut data-queue-fair-extra qui est disponible dans la balise JavaScript côté client et dans l'implémentation de Google Tag Manager. Veuillez contacter le service d'assistance si vous souhaitez activer les pages de file d'attente dynamiques sur votre compte.

Vous pouvez utiliser cette fonctionnalité pour personnaliser les pages de la file d'attente à la volée. Vous pouvez également utiliser Queue-Fair pour transmettre à votre site les données que vous nous envoyez avec vos visiteurs lorsqu'ils passent par la file d'attente, pour une couche supplémentaire de sécurité.

Nous fournissons également une API de page d'attente dynamique qui utilise les données supplémentaires pour personnaliser n'importe quel aspect d'une page d'attente, de sorte que vous pouvez créer une file d'attente pour l'ensemble de votre site et la personnaliser automatiquement pour différents événements ou produits sur votre site, sans avoir à apporter des modifications à vos pages d'attente dans le portail Queue-Fair.



Gestion des files d'attente Shopify, WooCommerce et Wordpress

Si vous utilisez un site basé sur Wordpress, tel que le système de panier d'achat WooCommerce, vous pouvez facilement ajouter la balise Client-Side JavasScript Adapter à l'aide du plugin Wordpress Insert Headers & Footers, sans devoir modifier vos thèmes ou modèles ni toucher au code Wordpress.

Il suffit de télécharger le plugin Insert Headers & Footers, de le décompresser dans votre dossier /wp-content/plugins/, d'activer le plugin dans le menu Plugins, d'ouvrir le plugin dans le menu Paramètres, d'ajouter la balise à Scripts in Header comme indiqué, de cliquer sur Enregistrer en bas de la page et le tour est joué ! La gestion des files d'attente Wordpress simplifiée. Il existe d'autres plugins Wordpress que vous pouvez utiliser pour ajouter la balise - celui-ci est le plus populaire.

Shopify est tout aussi facile - voici les instructions pour ajouter l'adaptateur JavaScript côté client Queue-Fair à votre boutique Shopify.

les marques rejoignent des modèles pour le contrôle de l'arrière-plan sur le point de contrôle

Ressources supplémentaires pour l'adaptateur côté client

L'adaptateur côté client est entièrement décrit dans le guide technique. Le guide technique est disponible dans le portail Queue-Fair > Aide, ou vous pouvez nous en demander une copie.


Adaptateurs côté serveur

Alors que l'adaptateur côté client s'exécute en JavaScript dans le navigateur de vos visiteurs, les adaptateurs côté serveur de Queue-Fair s'exécutent sur votre serveur Web.

Adaptateurs de serveur Web

Cela signifie que votre serveur Web peut tirer parti de fonctions de sécurité supplémentaires pour refuser l'accès aux personnes qui n'ont pas été mises en file d'attente. Cela signifie également que votre serveur web évite la charge de générer et de servir des pages contenant le script de l'adaptateur.

L'ajout des bibliothèques de l'adaptateur Queue-Fair côté serveur ne prend que quelques minutes et les modifications du code sont minimes pour activer et exécuter l'adaptateur.

La plupart de nos clients commencent par l'adaptateur JavaScript côté client et ne passent à l'adaptateur côté serveur que lorsqu'il existe une fonctionnalité ou un besoin commercial spécifique.

Mode simple et sûr

Les adaptateurs côté serveur Queue-Fair peuvent fonctionner en mode simple ou sécurisé.

En mode simple, tous les visiteurs sont envoyés aux serveurs Queue-Fair pour être comptés, qu'une file d'attente se soit formée ou non. S'il y a une file d'attente, ils la rejoignent. S'il n'y a pas de file d'attente, ils sont renvoyés directement à votre serveur Web, sans voir de page de file d'attente, mais avec la signature dont votre serveur Web a besoin pour s'assurer que seules les personnes qui sont passées par la file d'attente peuvent accéder à vos ressources protégées.

En mode sans échec, les visiteurs ne sont envoyés vers les serveurs Queue-Fair que lorsqu'il y a une file d'attente. Votre serveur web consulte directement nos serveurs de file d'attente en arrière-plan pour prendre cette décision. Les visiteurs bénéficient toujours d'une signature numérique sécurisée, qu'ils rejoignent une file d'attente ou qu'ils passent sans voir de page de file d'attente parce que celle-ci est vide.

Le mode sans échec est recommandé pour les files d'attente quotidiennes. Le mode simple est approprié pour un événement ou une vente chronométrée lorsque vous attendez des milliers de personnes, car il élimine la latence due à l'appel de vérification de votre serveur web à nos serveurs de file d'attente, ce qui signifie que vous pouvez envoyer des personnes pour rejoindre la file d'attente plus efficacement.

Dépôts GitHub

filtre passé date matière contrôle vente société marques

PHP

Le dépôt GitHub pour l'adaptateur côté serveur de la salle d'attente virtuelle Queue-Fair en PHP.

wordpress exclut le tri des taxes pour affiner la recherche du système de file d'attente des prix.

Java

Le dépôt GitHub pour l'adaptateur côté serveur de la salle d'attente virtuelle Queue-Fair pour Java, y compris JBoss et Tomcat.

J'ai ajouté des options de suivi du temps et des termes et les emails tonumber beaucoup. J'aime beaucoup l'aspect nécessaire pour le système de file d'attente

Ruby

Dépôt GitHub de l'adaptateur côté serveur de la salle d'attente virtuelle Queue-Fair en Ruby et (éventuellement) Rails..

worpress exludes tax sort with refine price for wordpress.

Python

Le dépôt GitHub pour l'adaptateur côté serveur de la salle d'attente virtuelle Queue-Fair en Python et (en option) Django.

contrôle de l'arrière-plan plugins wordpress date de service pour la matière passée filtre semaine de vente signification des marques de l'entreprise sont mises à jour

.NET

Dépôt GitHub de l'adaptateur côté serveur de la salle d'attente virtuelle Queue-Fair pour .NET, ASP et C#.

éviter les postes communautaires d'action pour les tâches de prix et créer la propriété du plugin.

Node.js & JavaScript

Le dépôt GitHub de l'adaptateur côté serveur de la salle d'attente virtuelle Queue-Fair pour Node.js et (en option) Express.



Pages de file d'attente dynamique

Comme avec l'adaptateur côté client, toutes les données que vous souhaitez peuvent être transmises de votre serveur Web à nos serveurs et aux pages de file d'attente que vos visiteurs voient en transmettant ces informations dans l'appel de l'adaptateur côté serveur lorsque les personnes rejoignent la file d'attente. Cela facilite la personnalisation à la volée des pages de file d'attente dynamique ou autre de la même manière - toutes les fonctionnalités de l'adaptateur côté client sont entièrement prises en charge. Veuillez contacter le support si vous souhaitez activer les pages de file d'attente dynamique sur votre compte.

Adaptateur côté serveur Ressources supplémentaires

Nos adaptateurs côté serveur sont entièrement décrits dans le guide technique. Le guide technique est disponible dans le portail Queue-Fair > section Aide, ou vous pouvez nous en demander une copie. Vous pouvez également trouver plus d'informations sur chacun des adaptateurs dans le fichier README.md de chaque dépôt communautaire global GitHub.


Adaptateurs de bord de réseau

Les adaptateurs Queue-Fair Network-Edge fonctionnent dans le cadre de votre CDN ou de votre fournisseur de services en nuage, plutôt que dans les navigateurs des visiteurs ou sur votre serveur d'origine.

Adaptateurs Lambda et CDN Provider

Cela donne les mêmes fonctionnalités et la même sécurité que l'adaptateur côté serveur et la même protection de la charge que Direct Link.

L'ajout des bibliothèques Queue-Fair Network-Edge Adapter ne prend que quelques minutes avec des changements de code minimes sur votre fournisseur de cloud pour activer et exécuter l'adaptateur, qui est normalement déployé comme une fonction Lambda ou Edge Worker.

Mode simple et sûr

Comme nos adaptateurs côté serveur, nos adaptateurs côté réseau peuvent fonctionner en mode simple ou sûr.

Adaptateurs disponibles

Marques Php à dollars avec service de contrôle d'arrière-plan sur point.  Date du mois dernier, filtre par semaine pour les marques d'entreprise.

CloudFront

Adaptateur de salle d'attente virtuelle Amazon AWS CloudFront Network-Edge.

affiner le prix hors taxe trier les plugins wordpress rechercher les postes de la communauté pour les tâches de prix avec la propriété plugin.

Cloudflare

Adaptateur de salle d'attente virtuelle Cloudflare Network-Edge

wordpress refine price excludes tax sort search.  Community posts tasks plugin property with price create.

Fastly

Adaptateur de salle d'attente virtuelle Fastly Network-Edge..

Php marques point dollars au service de contrôle de fond. Past date filtrer la question pour la semaine de vente, ce qui signifie que les marques de l'entreprise envoyer apprendre signal.

Akamai

Adaptateur de salle d'attente virtuelle d'Akamai Network-Edge.



Pages de file d'attente dynamique

Comme avec l'adaptateur côté client, toutes les données que vous souhaitez peuvent être transmises de votre site à nos serveurs et aux pages de la file d'attente que vos visiteurs voient en transmettant ces informations dans l'appel de l'adaptateur. Cela facilite la personnalisation des pages de file d'attente dynamique ou d'autres personnalisations à la volée, car les personnes rejoignent la file d'attente de la même manière - toutes les fonctionnalités de l'adaptateur côté client sont entièrement prises en charge. Veuillez contacter le support si vous souhaitez activer les pages de file d'attente dynamique sur votre compte.

Adaptateur de bord de réseau Ressources supplémentaires

Nos adaptateurs Network-Edge sont entièrement décrits dans le Guide technique. Le guide technique est disponible dans le portail Queue-Fair > section Aide, ou vous pouvez nous en demander une copie. Vous pouvez également trouver plus d'informations sur chacun des adaptateurs dans le fichier README.md de chaque dépôt communautaire global GitHub.


APIs REST

Queue-Fair donne aux développeurs l'accès à six modules API REST. Vous aurez besoin d'un compte Queue-Fair pour utiliser l'API. Pour activer l'accès à l'API pour votre compte, veuillez contacter l'assistance Queue-Fair. Nos modules API REST sont conformes aux normes OpenAPI, RFC 7807 et RFC 3339.

Notre suite de modules API est complète - tout ce que vous pouvez faire dans le portail, vous pouvez également le faire avec l'API, à l'exception de la gestion des utilisateurs du portail qui est exclue pour des raisons de confidentialité.

Chaque module API est entièrement documenté sur api.queue-fair.net, où vous trouverez également une interface Swagger pour faciliter l'utilisation et les tests. Pour des raisons de sécurité, tous les appels API sont protégés par un cryptage TLS sécurisé et nécessitent une clé API spécifique à votre compte.

Modules API

API de rapport

Pour obtenir des rapports en direct et en temps réel, des rapports historiques et des statistiques globales sur les files d'attente.

API de gestion des files d'attente

Pour créer et modifier les files d'attente de manière programmatique et en temps réel.

API de gestion de compte

Pour consulter et mettre à jour les paramètres de votre compte.

API de gestion des actifs

Pour gérer les actifs utilisés par vos pages de file d'attente servies par Google CDN.

API de présentation

Pour modifier tout aspect du HTML de vos pages de file d'attente et mettre à jour et créer des variantes à la volée.

API d'activation

Pour configurer les règles d'activation qui déterminent quelles pages de votre site peuvent déclencher une file d'attente, et quelle page est affichée.



Pages de file d'attente dynamique

Vous pouvez également modifier vos pages de file d'attente à la volée sans avoir à mettre à jour la base de données en utilisant le portail ou l'API de présentation. Contactez le support pour plus de détails et pour activer les pages de file d'attente dynamiques sur votre compte.

Ressources supplémentaires pour l'API REST

Comme l'exige la RFC 7807, vous pouvez trouver de la documentation sur les messages d'erreur qui peuvent être renvoyés par nos modules API REST à l'adresse queue-fair.com/api-error.


Applications natives

Queue-Fair s'adapte aussi bien aux navigateurs mobiles qu'aux ordinateurs de bureau et portables.

Vous pouvez également utiliser Queue-Fair directement dans vos applications natives iOS et Android, ainsi que dans les applications React Native sur iOS, Android, Windows et MacOS, pour protéger les activités ou opérations gourmandes en ressources.

Les adaptateurs d'applications Queue-Fair utilisent un WebClient pour connecter des applications et afficher des files d'attente personnalisées à l'intention de vos utilisateurs lorsque vos services sont trop occupés, avec la souplesse et la facilité d'utilisation de l'application Queue-Fair Portal.

Vous pouvez placer les utilisateurs dans la même file d'attente que les visiteurs de votre site web, ou créer une file d'attente distincte pour les utilisateurs de votre application - c'est vous qui voyez.

Tout comme nos files d'attente en ligne, une fois qu'ils ont rejoint la file d'attente, la place de chaque utilisateur est automatiquement sauvegardée s'ils quittent votre application.

Dépôts GitHub

Php marques point dollars au service de contrôle de fond. Past date filtrer la question pour la semaine de vente, ce qui signifie que les marques de l'entreprise envoyer apprendre signal.

iOS & MacOS

Le dépôt GitHub pour l'adaptateur iOS et MacOS de la salle d'attente virtuelle Queue-Fair.

envoyer l'action mise à jour éviter ajouté à,e à suivre faire des options

Android

Le dépôt GitHub pour l'adaptateur de salle d'attente virtuelle Queue-Fair pour Android.

envoyer action mise à jour éviter ajouté à suivre faire des options

React Native

Le dépôt GitHub pour l'adaptateur de salle d'attente virtuelle Queue-Fair pour les applications React Native pour Android, iOS, MacOS et Windows.

Notifications de la file d'attente

L'adaptateur Queue-Fair dispose de callbacks qui facilitent l'envoi de notifications push aux utilisateurs qui n'utilisent pas votre application ou votre file d'attente lorsque leur tour est appelé. La place de l'utilisateur dans la file d'attente est automatiquement stockée de manière persistante par l'adaptateur dans votre application. Si l'utilisateur s'éloigne de votre application, celle-ci indique à votre serveur de notification Push qu'une notification doit être envoyée, en envoyant les informations relatives à la position dans la file d'attente dans le cadre de ce message à votre serveur de notification Push.

Il s'agit de la même technologie que celle utilisée pour notre application et notre service WeQ4U, qui a été téléchargée à près de deux millions d'exemplaires rien qu'au Royaume-Uni.

Votre serveur de notification Push Notification consulte périodiquement l'API d'état Queue-Fair pour demander la position de la file d'attente actuellement servie. Lorsque cette position est supérieure à celle de la file d'attente d'un utilisateur particulier, il est temps de contacter cet utilisateur avec la notification. Si l'utilisateur retourne dans la file d'attente ou passe avant l'envoi de la notification, les rappels de l'adaptateur en informent votre application, et celle-ci indique à votre serveur de notification que la notification n'est plus nécessaire.

À notre connaissance, nous sommes le seul fournisseur de salles d'attente virtuelles à prendre en charge cette fonctionnalité.

Ressources vidéo

Voici une vidéo de l'adaptateur pour applications natives en action, montrant que la place de l'utilisateur est sauvegardée même si l'application est complètement arrêtée, et montrant également les crochets de l'adaptateur que votre application utilise pour envoyer des notifications push.

Ressources supplémentaires

Nos adaptateurs d'applications natives sont décrits dans le guide technique. Le guide technique est disponible dans le portail Queue-Fair > section Aide, ou vous pouvez nous en demander une copie. Vous pouvez également trouver plus d'informations sur chacun des adaptateurs spécifiques à iOS et Android dans le README.md de chaque dépôt communautaire global GitHub.


Adaptateurs pour le commerce électronique

Queue-Fair peut être ajouté facilement à tout système de commerce électronique en utilisant l'adaptateur JavaScript côté client décrit ci-dessus.

Nous proposons également un code adaptateur pour travailler du côté serveur avec de nombreux serveurs de commerce électronique populaires.

Dépôts GitHub

Créez des dollars php pour les marques grâce à des modèles et des plugins wordpress bien conçus.

Magento

Le dépôt GitHub pour l'adaptateur de salle d'attente virtuelle Queue-Fair pour Magento.

Recherchez dans les messages de la communauté les tâches et les prix les plus courants.

WooCommerce

Créer des dollars de propriété plugin pour php et les marques

La date de service du point de fond n'a pas d'importance.  La semaine de filtrage passée évite toute signification.

PrestaShop

Le dépôt GitHub pour l'adaptateur de salle d'attente virtuelle Queue-Fair pour PrestaShop en PHP.

Ressources supplémentaires

Nos adaptateurs sont décrits dans le guide technique. Le guide technique est disponible dans le portail Queue-Fair > Aide, ou vous pouvez nous en demander une copie.

Nous disposons également de guides supplémentaires pour la plupart des plateformes de commerce électronique - il suffit de demander celui que vous souhaitez.


Sécurité hybride

Vous pouvez facilement combiner la flexibilité de l'adaptateur JavaScript côté client avec la couche de sécurité supplémentaire fournie par notre code côté serveur.

Queue-Fair signe chaque visiteur que nous faisons passer avec une empreinte digitale numérique qui est unique à ce visiteur. Fait unique dans le secteur, la signature comprend également un code spécifique au navigateur du visiteur, afin d'empêcher le partage des jetons d'accès.

Votre serveur web peut valider la signature à l'aide d'un secret connu uniquement de vous et de nous - et non de vos visiteurs - afin de garantir que chaque visiteur est passé équitablement par les serveurs Queue-Fair.

Ainsi, vous pouvez utiliser l'adaptateur JavaScript côté client pour envoyer et recevoir des visiteurs vers et depuis la file d'attente, et vérifier qu'ils ne sont pas altérés avant qu'ils ne passent commande avec un minimum de code côté serveur, et éviter d'introduire une dépendance sur notre système.

Des exemples de code sont inclus dans nos dépôts communautaires mondiaux GitHub dans tous les principaux langages de programmation web.

Dépôts GitHub

PHP

PHP

Le dépôt GitHub pour l'adaptateur côté serveur de la salle d'attente virtuelle Queue-Fair en PHP.

Java

Java

Le dépôt GitHub pour l'adaptateur côté serveur de la salle d'attente virtuelle Queue-Fair pour Java, y compris JBoss et Tomcat.

Ruby

Ruby

Le dépôt GitHub pour l'adaptateur côté serveur de la salle d'attente virtuelle Queue-Fair en Ruby et (éventuellement) Rails.

Python

Python

Le dépôt GitHub pour l'adaptateur côté serveur de la salle d'attente virtuelle Queue-Fair en Python et (en option) Django.

.NET

.NET

Dépôt GitHub de l'adaptateur côté serveur de la salle d'attente virtuelle Queue-Fair pour .NET, ASP et C#.

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

Node.js & JavaScript

Le dépôt GitHub de l'adaptateur côté serveur de la salle d'attente virtuelle Queue-Fair pour Node.js et (en option) Express.

Ressources supplémentaires

Le modèle de sécurité hybride est entièrement décrit dans le guide technique. Le guide technique est disponible dans le portail Queue-Fair > Aide, ou vous pouvez nous en demander une copie.


Licence

Le code que nous avons publié et qui est disponible sur le dépôt GitHub Queue-Fair est protégé par la licence MIT, qui est l'une des licences Open Source les plus permissives pour la communauté internationale.


Vous voulez savoir comment fonctionne le Queue-Fair ?