Recursos para desenvolvedores



Adicionando Queue-Fair

A Sala de Espera Virtual Queue-Fair é facilmente adicionada a uma ampla variedade de plataformas da Web e de aplicativos em minutos. Basta usar um de nossos adaptadores. Para obter mais informações sobre a melhor maneira de integrar o serviço Queue-Fair ao seu sistema existente, consulte o Guia Técnico ou a seção Portal Queue-Fair > Ajuda. Se você estiver procurando informações sobre como impedir que bots ou humanos façam vários pedidos, ou proteger suas vendas NFT de taxas excessivas de gás, você pode ler esta visão geral ou obter detalhes completos na seção Guia de Segurança do Portal.

A maneira mais rápida de começar com o Queue-Fair é se inscrever em um Nível gratuito conta - você pode fazer isso online agora e começar a integrar e testar imediatamente.

Precisa de ajuda para definir as tarifas de sua fila? Tudo o que você precisa saber está aqui.

O Adaptador do lado do cliente

Para websites, a maneira mais simples de integrar com Queue-Fair é adicionar a tag JavaScript do Adaptador Queue-Fair do lado do Cliente a suas páginas. Você pode seguramente adicionar o Adaptador a todas as páginas de seu site, e usar as Regras de Ativação no Portal Queue-Fair para determinar quais páginas podem lançar uma fila.

Nosso adaptador JavaScript do lado do cliente é mais seguro do que as peças de integração do lado do cliente de outros provedores. Como é executado nos navegadores de seus visitantes, o Client-Side Adapter pode ser adulterado por visitantes tecnicamente habilidosos, mas é muito eficaz na prevenção de sobrecarga, pois apenas uma minoria muito pequena de pessoas tentará ignorar a fila adulterando o JavaScript. A maioria dos nossos clientes usa o Client-Side Adapter porque ele é eficaz para evitar que o site trave, é simples de instalar e não introduz nenhuma dependência entre o nosso sistema e o seu. Ao contrário das peças de integração do lado do cliente de outros provedores, ele pode ser tornado à prova de adulteração com o Hybrid Security Model descrito no Guia Técnico.

Você pode adicionar uma camada de segurança substituindo a tag JavaScript por um Adaptador Server-Side, ou combinar a flexibilidade do Adaptador JavaScript com o Modelo Híbrido de Segurança descrito nesta página; ambos os métodos são então seguros.

Linha única de código

Para adicionar o Adaptador Client-Side ao seu site, basta adicionar a seguinte linha única de código ao <head> seção de suas páginas:

a comunidade global exclui o sistema de filas de espera para plugins wordpress

Alguns clientes acrescentam a palavra defer à tag, o que faz com que o script do Adaptador seja carregado em paralelo à análise da página e também para iniciar a execução do script no navegador do visitante somente quando a página tiver terminado a análise (portanto, normalmente depois que qualquer outro script em sua página tiver terminado).

Adicionar a palavra adiar pode melhorar o Tempo para Primeira Tinta por uma pequena fração de segundo em alguns casos, mas se você optar por fazer isso, isso significará que qualquer visitante que deva ser deixado em fila verá sua página protegida por uma fração de segundo a mais antes de ser enviado para a fila.

Gerenciador de tags do Google

Nós também fornecemos o JavaScript Adapter Tag via Google Tag Manager. Procure por Queue-Fair na Galeria de Modelos Comunitários, em Adicionar Tag. Observe que alguns bloqueadores de anúncios impedem o download do gtm.js mestre do Google, que bloqueia todas as operações do Google Tag Manager, incluindo a execução do Adapter do sistema de fila de espera para esses visitantes.

plugins wordpress wp cron ótima ferramenta para busca wordpress e postagens na comunidade do site a um ótimo preço

Repositórios GitHub

wordpress tasks plugin propriedade para criar dólares de dados sem necessidade de php

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.

marcas unem modelos para controle de callback no ponto de fundo

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.


Adaptadores do lado do servidor

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



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.


Adaptadores de Rede-Edge

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



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.


REST APIs

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


Aplicações nativas

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

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.


Adaptadores de ECommerce

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

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.


Segurança Híbrida

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

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.


Licença

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.


Deseja saber como funciona o Queue-Fair?