Recursos para desenvolvedores

Gerenciador de tags do Google

O repositório GitHub para a Sala de Espera Virtual Queue-Fair Google Tag Manager Client-Side Adapter Tag.

Páginas de Fila Dinâmica

Qualquer dado que você desejar pode ser passado de seu site para nosso sistema de fila de espera e as Páginas de Fila de Espera que seus visitantes vêem utilizando o atributo data-queue-fair-extra que está disponível na tag JavaScript do lado do cliente e na implementação do Google Tag Manager. Favor entrar em contato com o suporte se desejar ativar as Páginas de Fila Dinâmicas em sua conta.

Você pode usar este recurso para personalizar as Páginas de Fila na mosca. Você também pode usar o Queue-Fair para passar os dados que você nos envia com seus visitantes de volta ao seu site à medida que eles são passados pela fila, para uma camada adicional de segurança.

Também fornecemos uma API de Página de Fila Dinâmica que usa os dados extras para personalizar qualquer aspecto de uma Página de Fila, para que você possa criar uma fila para todo o seu site e personalizá-la automaticamente para diferentes eventos ou produtos em seu site, sem ter que fazer qualquer alteração em suas Páginas de Fila no Portal Queue-Fair

Shopify, WooCommerce & Wordpress gerenciamento de filas

Se você estiver usando um site baseado no Wordpress, como o sistema de carrinho de compras WooCommerce, você pode facilmente adicionar a tag Adaptador JavasScript do lado do cliente usando o plugin Inserir Cabeçalhos e Rodapés do Wordpress, sem ter que modificar nenhum de seus Temas ou modelos ou tocar em qualquer código do Wordpress.

Basta baixar o Plugin Insert Headers & Footers, descompactá-lo para sua pasta /wp-content/plugins/, ativar o plugin no menu Plugins, abrir o plugin no menu Settings, adicionar a tag ao Scripts no Cabeçalho como mostrado, pressionar Save no final da página, e pronto! O gerenciamento da fila do Wordpress tornou-se simples. Existem outros plugins Wordpress que você pode usar para adicionar a tag também - este é o mais popular.

Alguns clientes do Wordpress gostam de adicionar a tag Queue-Fair JavaScript a suas páginas de erro do Wordpress também, o que você pode fazer editando /wp-includes/functions.php - adicioná-lo ao HTML contido na função _default_wp_die_handler nesse arquivo.

Aqui estão as instruções para adicionar o adaptador JavaScript do lado do cliente Queue-Fair à sua loja do Shopify - use os três pontos no canto superior esquerdo depois de clicar em Personalizar para editar o código no arquivo de layout theme.liquid.

Sala de espera virtual SquareSpace do lado do cliente

O adaptador JavaScript do lado do cliente também é muito fácil de adicionar ao seu site do SquareSpace - faça login e selecione seu site, depois Website na navegação à esquerda, Ferramentas do site (na seção Utilitários na navegação à esquerda), Injeção de código e, em seguida, copie e cole-o na caixa Cabeçalho e, depois, Salvar no canto superior esquerdo.

Para obter segurança máxima no SquareSpace, use nosso adaptador SquareSpace Network-Edge Adapter, descrito abaixo.

Adaptador do lado do cliente Recursos adicionais

O Adaptador do lado do cliente está totalmente descrito no Guia Técnico. O Guia Técnico está disponível na seção Portal Queue-Fair > Ajuda, ou você pode solicitar uma cópia de nós.

Enquanto o Adaptador Client-Side roda em JavaScript nos navegadores de seus visitantes, os Adaptadores Queue-Fair Server-Side rodam em seu webserver.Isso significa que seus servidores podem enviar visitantes para a fila de forma mais eficiente. Os agentes mal-intencionados não verão o conteúdo do seu site; no entanto, os bots ainda podem fazer solicitações aos seus servidores, portanto, para obter proteção total contra DDoS, use um dos nossos adaptadores de borda de rede abaixo.

Adaptadores para Servidores Web

Isto significa que seu servidor web pode tirar proveito de recursos adicionais de segurança para negar o acesso às pessoas que não foram enfileiradas. Isto também significa que seu servidor web evita a carga de gerar e servir páginas contendo o script do Adaptador.

Adicionar as bibliotecas do Queue-Fair Server-Side Adapter leva apenas alguns minutos com o mínimo de mudanças de código para ativar e executar o Adapter.

A maioria de nossos clientes começa com o Adaptador JavaScript do lado do cliente e passa para o Adaptador do lado do servidor somente onde há uma funcionalidade específica ou necessidade comercial.

Modo simples e seguro

Os adaptadores Queue-Fair Server-Side podem operar em modo simples ou seguro.

No Modo Simples, todos os visitantes são enviados aos Servidores Queue-Fair para serem contados, independentemente de ter sido formada ou não uma Fila de espera. Quando há uma fila, eles se juntam à fila. Quando não há fila, eles são devolvidos ao seu Servidor Web imediatamente, sem ver uma Página de Fila - mas com a assinatura de seu Servidor Web precisa garantir que somente pessoas que passaram pela fila possam acessar seus recursos protegidos.

No Modo Seguro, os visitantes só são enviados para os Servidores Queue-Fair quando há uma Fila de espera. Seu servidor web consulta diretamente nossos Servidores de Fila em segundo plano para fazer esta determinação. Os visitantes ainda são assinados digitalmente com segurança, quer se juntem a uma fila, quer sejam Passados sem ver uma Página de Fila porque a fila está vazia.

O Modo Seguro é recomendado para as filas do dia-a-dia. O modo simples é apropriado para um evento ou venda cronometrada quando você está esperando milhares de pessoas, pois elimina a latência devido à chamada de verificação do seu servidor web para nossos Servidores de Fila, o que significa que você pode enviar pessoas para entrar na fila de forma mais eficiente.

Repositórios GitHub

PHP

O repositório GitHub para o Queue-Fair Virtual Waiting Room Server-Side Adapter em PHP.

Java

O repositório GitHub para o Queue-Fair Virtual Waiting Room Server-Side Adapter para Java, incluindo JBoss e Tomcat.

Ruby

O repositório GitHub para o Queue-Fair Adaptador do lado do servidor da sala de espera virtual em Ruby e (opcionalmente) Rails.

Python

O repositório GitHub para o Queue-Fair Virtual Waiting Room Server-Side Adapter em Python e (opcionalmente) Django.

.NET

O repositório GitHub para o Queue-Fair Virtual Waiting Room Server-Side Adapter para .NET, ASP e C#.

Node.js & JavaScript

O repositório GitHub para o Queue-Fair Virtual Waiting Room Server-Side Adapter for Node.js e (opcionalmente) Express.

Páginas de Fila Dinâmica

Assim como no Adaptador do lado do cliente, quaisquer dados que você desejar podem ser passados de seu servidor web para nossos servidores e as Páginas de Fila que seus visitantes vêem ao passar estas informações na chamada do Adaptador do lado do servidor à medida que as pessoas entram na fila. Isto facilita a Página de Fila Dinâmica ou outra personalização no vôo da mesma forma - todas as características do Adaptador do lado do Cliente são totalmente suportadas. Entre em contato com o suporte se desejar ativar as Páginas Dinâmicas de Fila de Espera em sua conta.

Adaptador do lado do servidor Recursos adicionais

Nossos adaptadores do lado do servidor estão totalmente descritos no Guia Técnico. O Guia Técnico está disponível na seção Portal Queue-Fair > Ajuda, ou você pode solicitar uma cópia de nós. Você também pode encontrar mais informações sobre cada um dos Adaptadores no README.md de cada repositório da comunidade global GitHub.

Os adaptadores Queue-Fair Network-Edge são executados dentro da estrutura de seu provedor CDN ou Cloud Services, em vez de nos navegadores dos visitantes ou em seu servidor de origem. Essa é a melhor maneira de usar o Queue-Fair para proteger seus servidores contra ataques de bots, inclusive ataques DDoS.

Lambda e CDN Adaptadores de Fornecedores

Isto dá a mesma funcionalidade e segurança que o Adaptador Server-Side e a mesma proteção de carga que o Direct Link.

Adicionar as bibliotecas do adaptador Queue-Fair Network-Edge leva apenas alguns minutos com mudanças mínimas de código em seu provedor de nuvem para ativar e executar o adaptador, que normalmente é implantado como uma função Lambda ou Edge Worker.

Modo simples e seguro

Como com nossos adaptadores do lado do servidor, nossos adaptadores de rede podem operar em modo simples ou seguro.

Adaptadores disponíveis

CloudFront

Amazon AWS CloudFront Network-Edge Adaptador de Sala de Espera Virtual.

Cloudflare

Adaptador de Sala de Espera Virtual Cloudflare Network-Edge

Fastly

Adaptador de Sala de Espera Virtual Fastly Network-Edge..

Akamai

Akamai Network-Edge Adaptador de Sala de Espera Virtual.

Páginas de Fila Dinâmica

Assim como no Adaptador Client-Side, quaisquer dados que você desejar podem ser passados de seu site para nossos servidores e as Páginas de Fila que seus visitantes vêem ao passar estas informações na chamada do Adaptador. Isto facilita a Página de Fila Dinâmica ou outra personalização em tempo real, pois as pessoas entram na fila da mesma forma - todas as características do Adaptador Client-Side são totalmente suportadas. Entre em contato com o suporte se desejar ativar as Páginas Dinâmicas de Fila de Espera em sua conta.

Adaptador de Rede-Edge Recursos adicionais

Nossos Adaptadores de Rede-Edge estão totalmente descritos no Guia Técnico. O Guia Técnico está disponível na seção Portal Queue-Fair > Ajuda, ou você pode solicitar uma cópia de nós. Você também pode encontrar mais informações sobre cada um dos Adaptadores no README.md de cada repositório global da comunidade GitHub.

O Queue-Fair dá aos desenvolvedores acesso a seis Módulos API REST. Você precisará de uma conta Queue-Fair para usar a API. Para ativar o acesso à API para sua conta, entre em contato com o Suporte Queue-Fair. Nossos Módulos REST API estão em conformidade com as normas OpenAPI, RFC 7807 e RFC 3339.

Nosso conjunto de Módulos API é abrangente - qualquer coisa que você possa fazer no Portal, você também pode fazer com a API, exceto gerenciar Usuários do Portal, o que é excluído por razões de privacidade.

Cada módulo API é totalmente documentado no api.queue-fair.net, onde você também encontrará uma interface Swagger para facilidade de uso e teste. Para segurança, todas as chamadas API são protegidas por criptografia TLS segura e requerem uma chave API específica para sua conta.

Módulos API

Páginas de Fila Dinâmica

Você também pode modificar suas Páginas de Fila de Espera em tempo real sem ter que atualizar o banco de dados usando o Portal ou a API de Apresentação - Contate o Suporte para maiores detalhes e para ativar as Páginas de Fila Dinâmicas em sua conta.

Recursos adicionais REST API

Como requerido pelo RFC 7807, você pode encontrar documentação sobre mensagens de erro que podem ser retornadas por nossos Módulos API REST em queue-fair.com/api-error

O Queue-Fair fica ótimo em navegadores móveis, assim como em desktops e laptops.

Você também pode usar o Queue-Fair diretamente em seus aplicativos nativos iOS e Android, e também Reagir aplicativos nativos em iOS, Android, Windows e MacOS, para proteger atividades ou operações de recursos intensivos.

Os adaptadores de aplicativos Queue-Fair usam um Cliente Web para conectar aplicativos e exibir exibições de fila personalizadas para seus usuários quando seus serviços estão muito ocupados, com a flexibilidade e facilidade de uso do Queue-Fair Portal.

Você pode enfileirar os usuários na mesma fila que os visitantes de seu site, ou criar uma fila separada para os usuários de seu aplicativo - isso depende de você.

Assim como nossas filas baseadas na web, uma vez que elas se juntam à fila, o lugar de cada usuário é automaticamente salvo se ele também navegar para longe de seu aplicativo.

Repositórios GitHub

iOS & MacOS

O repositório GitHub para a Sala de espera virtual Queue-Fair iOS e MacOS Adapter.

Android

O repositório GitHub para o Adaptador de Sala de Espera Virtual Queue-Fair para Android.

React Native

O repositório GitHub para o Adaptador de Sala de Espera Virtual Queue-Fair para aplicativos React Native para Android, iOS, MacOS e Windows.

Notificações de fila

O Adaptador Queue-Fair tem callbacks que facilitam o envio de Notificação de Push aos usuários que não estão usando seu aplicativo ou fila quando sua vez é chamada. O lugar do usuário na fila é automaticamente armazenado de forma persistente pelo Adaptador em seu aplicativo. Se o usuário navegar para longe de seu aplicativo, seu aplicativo diz a seu servidor de Notificação Push que uma notificação deve ser enviada, enviando a informação armazenada da posição da fila como parte dessa mensagem para seu servidor de Notificação Push.

É a mesma tecnologia que usamos para nosso aplicativo e serviço ao consumidor WeQ4U, que teve cerca de 2 milhões de downloads somente no Reino Unido.

Seu servidor Push Notification consulta periodicamente a API de status Queue-Fair para consultar a posição da fila que está sendo atendida atualmente. Quando esta é maior que a posição de um determinado usuário na fila, é hora de contatar esse usuário com a notificação. Se o usuário retornar à fila ou for Passado antes que uma Notificação Push tenha sido enviada, as chamadas no Adaptador notificam seu aplicativo, e seu aplicativo informa ao servidor de Notificação Push que a notificação não é mais necessária.

Segundo nosso conhecimento, somos o único fornecedor de Sala de Espera Virtual que apóia este recurso.

Recursos em vídeo

Aqui está um vídeo do Adaptador Nativo em ação, mostrando que o lugar do usuário é salvo mesmo que o aplicativo esteja completamente parado, e também mostrando os ganchos do Adaptador que seu aplicativo usa para enviar Notificações Push.

Recursos adicionais

Nossos adaptadores de aplicação nativos estão descritos no Guia Técnico. O Guia Técnico está disponível na seção Portal Queue-Fair > Ajuda, ou você pode solicitar uma cópia de nós. Você também pode encontrar mais informações sobre cada um dos Adaptadores que são específicos para iOS e Android no README.md de cada repositório da comunidade global GitHub.

O Queue-Fair pode ser adicionado facilmente a qualquer sistema de eCommerce usando o Adaptador JavaScript do lado do cliente descrito acima.

Também oferecemos código Adaptador para trabalhar no lado do servidor com muitos servidores de eCommerce populares.

Repositórios GitHub

Magento

O repositório GitHub para o Queue-Fair Adaptador de Sala de Espera Virtual para Magento.

WooCommerce

O repositório GitHub para o Queue-Fair Adaptador de Sala de Espera Virtual para WooCommerce em PHP.

PrestaShop

O repositório GitHub para o Queue-Fair Adaptador de Sala de Espera Virtual para PrestaShop em PHP.

SquareSpace

O repositório do GitHub para o adaptador de sala de espera virtual Queue-Fair para SquareSpace.

Recursos adicionais

Nossos adaptadores estão descritos no Guia Técnico. O Guia Técnico está disponível na seção Portal Queue-Fair > Ajuda, ou você pode solicitar uma cópia de nós.

Temos também guias suplementares disponíveis para a maioria das plataformas de comércio eletrônico - basta pedir aquele que você deseja.

Você pode facilmente combinar a flexibilidade do Adaptador JavaScript do lado do cliente com a camada adicional de segurança fornecida por nosso código do lado do servidor.

Queue-Fair assina cada visitante que passamos com uma impressão digital que é única para aquele Visitante. Exclusivamente no setor, a assinatura também inclui código específico do navegador do visitante, para evitar que os tokens de acesso sejam compartilhados.

Seu servidor web pode validar a assinatura usando um segredo conhecido somente por você e por nós - não por seus visitantes - para garantir que cada visitante tenha sido passado de forma justa pelos servidores Queue-Fair.

Assim, você pode usar o Adaptador JavaScript do lado do cliente para enviar e receber visitantes de e para a fila de espera, e verificar se há adulteração antes que eles façam o pedido com um código mínimo do lado do servidor, e evitar introduzir uma dependência em nosso sistema.

O código de exemplo está incluído em nossos repositórios comunitários globais GitHub em todas as principais linguagens de programação web.

Repositórios GitHub

PHP

O repositório GitHub para o Queue-Fair Virtual Waiting Room Server-Side Adapter em PHP.

Java

O repositório GitHub para o Queue-Fair Virtual Waiting Room Server-Side Adapter para Java, incluindo JBoss e Tomcat.

Ruby

O repositório GitHub para o Queue-Fair Virtual Waiting Room Server-Side Adapter em Ruby e (opcionalmente) Rails.

Python

O repositório GitHub para o Queue-Fair Virtual Waiting Room Server-Side Adapter em Python e (opcionalmente) Django.

.NET

O repositório GitHub para o Queue-Fair Virtual Waiting Room Server-Side Adapter para .NET, ASP e C#.

Node.js & JavaScript

O repositório GitHub para o Queue-Fair Virtual Waiting Room Server-Side Adapter for Node.js e (opcionalmente) Express.

Recursos adicionais

O Modelo de Segurança Híbrido é descrito em sua totalidade no Guia Técnico. O Guia Técnico está disponível na seção Portal Queue-Fair > Ajuda, ou você pode solicitar uma cópia de nós.

Nosso código publicado disponível no The GitHub Queue-Fair Repository é licenciado sob a Licença MIT, que está entre as licenças Open Source mais permissivas para a comunidade global.