Ressources pour les développeurs

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.

Certains clients de Wordpress aiment aussi ajouter la balise JavaScript Queue-Fair à leurs pages d'erreur Wordpress, ce que vous pouvez faire en modifiant le fichier /wp-includes/functions.php - ajoutez-la au HTML contenu dans la fonction _default_wp_die_handler de ce fichier.

Shopify est tout aussi facile - voici les instructions pour ajouter l'adaptateur JavaScript côté client Queue-Fair à votre boutique Shopify - utilisez les trois points en haut à gauche après avoir cliqué sur Personnaliser pour modifier le code dans votre fichier de mise en page theme.liquid.

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.

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

PHP

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

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

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

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

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

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.

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

CloudFront

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

Cloudflare

Adaptateur de salle d'attente virtuelle Cloudflare Network-Edge

Fastly

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

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.

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

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.

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

iOS & MacOS

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

Android

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

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.

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

Magento

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

WooCommerce

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

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.

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

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

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

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

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

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

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.

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.