Recursos do Desenvolvedor



Acrescentar Queue-Fair

A Sala de Espera Virtual Queue-Fair é facilmente adicionada a uma grande variedade de plataformas web e de aplicações em minutos. Basta utilizar um dos nossos adaptadores. Pode encontrar mais informações sobre a melhor forma de integrar o serviço Queue-Fair com o seu sistema existente no Guia Técnico, ou no Portal Queue-Fair > secção Ajuda. Se estiver à procura de informações sobre como impedir bots ou humanos de fazerem múltiplas encomendas, ou proteger as suas vendas NFT de taxas excessivas de gás, pode ler esta visão geral ou obter detalhes completos na secção Guia de Segurança do Portal.

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

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

O Adaptador Client-Side

Para websites, a forma mais simples de integrar com Queue-Fair é adicionar a etiqueta JavaScript do Adaptador Queue-Fair do lado do Cliente às suas páginas. Pode seguramente adicionar o Adaptador a todas as páginas do seu site, e usar as Regras de Activação no Portal Queue-Fair para determinar quais as páginas que podem lançar uma fila.

O nosso Adaptador do lado do cliente JavaScript é mais seguro do que as peças de integração do lado do cliente de outros fornecedores. Uma vez que é executado nos browsers dos seus visitantes, o Adaptador do lado do cliente pode ser adulterado por visitantes tecnicamente qualificados, mas é muito eficaz na prevenção da sobrecarga, uma vez que apenas uma minoria muito pequena de pessoas tentará saltar a fila de espera adulterando o JavaScript. A maioria dos nossos clientes utiliza o Adaptador do lado do cliente porque é eficaz na prevenção de um sítio com falhas, é simples de instalar e não introduz qualquer dependência entre o nosso sistema e o seu. Ao contrário das peças de integração do lado do cliente de outros fornecedores, pode ser tornado à prova de adulteração com o Modelo de Segurança Híbrido descrito no Guia Técnico.

Pode adicionar uma camada de segurança substituindo a etiqueta JavaScript por um Adaptador do lado do servidor, 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> secção das suas páginas:

comunidade global exclui sistema de filas de espera para plugins wordpress

Alguns clientes acrescentam a palavra defer à etiqueta, o que faz com que o script do Adaptador seja carregado em paralelo com a análise da página e também só comece a execução do script no browser do visitante quando a página tiver terminado a análise (por isso, normalmente depois de qualquer outro script na sua página ter terminado).

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

Gestor de etiquetas Google

Também fornecemos o JavaScript Adapter Tag através do Google Tag Manager. Pesquise Queue-Fair na Galeria de Modelos Comunitários, em Add Tag. Note que alguns bloqueadores de anúncios impedem o download do master gtm.js 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 grande ferramenta para pesquisa wordpress e postagens na comunidade do site a um óptimo preço

Repositórios GitHub

wordpress tasks plugin propriedade para criar dólares de dados não é necessário php

Gestor de etiquetas Google

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

Páginas Dinâmicas de Fila de Espera

Quaisquer dados que deseje podem ser passados do seu site para o nosso sistema de fila de espera e as Páginas de Fila de Espera que os 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. Contacte o suporte se desejar activar as Páginas de Fila de Espera Dinâmicas na sua conta.

Pode utilizar esta funcionalidade para personalizar as Páginas de Fila na mosca. Também pode utilizar Queue-Fair para passar os dados que nos envia com os seus visitantes de volta ao seu site à medida que 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 utiliza os dados extra para personalizar qualquer aspecto de uma Página de Fila, para que possa criar uma fila para todo o seu site e personalizá-la automaticamente para diferentes eventos ou produtos no seu site, sem ter de fazer quaisquer alterações às suas Páginas de Fila no Portal Queue-Fair

.



Shopify, WooCommerce & Wordpress gestão de filas de espera

Se estiver a utilizar um site baseado em Wordpress, tal como o sistema de carrinho de compras WooCommerce, pode facilmente adicionar a etiqueta Adaptador JavasScript do lado do cliente utilizando o Plugin de Inserção de Cabeçalhos e Rodapés do Wordpress, sem ter de modificar qualquer dos seus Temas ou modelos ou tocar em qualquer código Wordpress.

Basta descarregar o Insert Headers & Footers Plugin, descompactá-lo para a sua pasta /wp-content/plugins/, activar o plugin no menu Plugins, abrir o plugin no menu Settings, adicionar a tag aos Scripts no Cabeçalho como mostrado, carregar em Save no fundo da página, e já está! A gestão de filas do Wordpress tornou-se simples. Existem outros plugins Wordpress que também pode utilizar para adicionar a tag - este é o mais popular.

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

O Shopify é igualmente fácil - aqui estão as instruções para adicionar o Adaptador JavaScript do lado do cliente Queue-Fair à sua loja Shopify - utilize os três pontos no canto superior esquerdo depois de clicar em Personalizar para editar o código no seu ficheiro theme.liquid Layout.

as marcas juntam modelos para o controlo de retorno de chamada de fundo pontual

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 SquareSpace - inicie sessão e seleccione o seu site, depois Website a partir da navegação esquerda, Ferramentas do site (na secção Utilitários na navegação esquerda), Injeção de código e, em seguida, copie e cole-o na caixa Cabeçalho e, em seguida, Guarde no canto superior esquerdo.

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


Adaptador do lado do cliente Recursos adicionais

O Adaptador Client-Side está totalmente descrito no Guia Técnico. O Guia Técnico está disponível na secção Portal Queue-Fair > Ajuda, ou pode solicitar-nos uma cópia.


Adaptadores do lado do servidor

Enquanto que o Adaptador Client-Side corre em JavaScript nos navegadores dos seus visitantes, os Adaptadores Queue-Fair Server-Side correm no seu servidor Web.Isto significa que os seus servidores podem enviar os visitantes para a fila de espera de forma mais eficiente. Os maus actores não verão o conteúdo do seu site, no entanto, os bots ainda podem fazer pedidos aos seus servidores, por isso, para uma proteção DDoS completa, utilize um dos nossos Adaptadores de Borda de Rede abaixo.

Adaptadores de Servidor Web

Isto significa que o seu servidor web pode tirar partido de características de segurança adicionais para negar o acesso a pessoas que não tenham sido enfileiradas. Isto também significa que o 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 alterações mínimas de código para activar e executar o Adaptador.

A maioria dos nossos clientes começa com o Adaptador JavaScript do lado do cliente e passa para o Adaptador Server-Side apenas onde existe 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 para os Servidores Queue-Fair para serem contados, quer se tenha formado ou não uma Fila de espera. Quando há uma fila, eles juntam-se à fila. Quando não há fila, eles são devolvidos ao seu Servidor Web imediatamente, sem verem uma Página de Fila - mas com a assinatura do seu Servidor Web precisa de assegurar que apenas pessoas que tenham sido passadas pela fila possam aceder aos seus recursos protegidos.

No Modo Seguro, os visitantes só são enviados para os Servidores Queue-Fair quando existe uma Fila de espera. O seu servidor Web consulta directamente os nossos Servidores de Fila de espera em segundo plano para fazer esta determinação. Os visitantes ainda são assinados digitalmente em segurança, quer se juntem a uma fila, quer sejam Passados sem verem 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 se espera milhares de pessoas, pois elimina a latência devido à chamada de verificação do seu servidor web para os nossos Servidores de Fila, o que significa que pode enviar pessoas para se juntarem à fila de forma mais eficiente.

Repositórios GitHub



Páginas Dinâmicas de Fila de Espera

Tal como no Adaptador do lado do Cliente, quaisquer dados que deseje podem ser passados do seu servidor web para os nossos servidores e as Páginas de Fila de espera que os seus visitantes vêem ao passar esta informação na chamada do Adaptador do lado do Servidor à medida que as pessoas entram na fila de espera. Isto facilita a Página de Fila Dinâmica ou outra personalização em tempo real da mesma forma - todas as características do Adaptador Client-Side são totalmente suportadas. Por favor contacte o suporte se desejar activar as Páginas de Fila Dinâmicas na sua conta.

Adaptador do lado do servidor Recursos adicionais

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


Adaptadores Network-Edge

Os Adaptadores Queue-Fair Network-Edge funcionam dentro da estrutura do seu fornecedor de CDN ou Cloud Services, e não nos browsers dos visitantes ou no seu servidor de origem. Esta é a melhor forma de utilizar o Queue-Fair para proteger os seus servidores contra ataques de bots, incluindo ataques DDoS.

Lambda e CDN Adaptadores de Fornecedores

Isto dá a mesma funcionalidade e segurança que o Adaptador do lado do servidor e a mesma protecção de carga que o Direct Link.

Adicionar as bibliotecas Queue-Fair Network-Edge Adapter leva apenas alguns minutos com alterações mínimas de código no seu fornecedor de nuvem para activar e executar o Adapter, que normalmente é implantado como uma função Lambda ou Edge Worker.

Modo simples e seguro

Tal como os nossos adaptadores do lado do servidor, os nossos adaptadores de Rede-Edge podem funcionar em modo Simples ou Seguro.

Adaptadores disponíveis



Páginas Dinâmicas de Fila de Espera

Tal como com o Adaptador Client-Side, quaisquer dados que deseje podem ser passados do seu site para os nossos servidores e as Páginas de Fila de Espera que os seus visitantes vêem ao passar esta informação na chamada do Adaptador. Isto facilita a Página de Fila Dinâmica ou outra personalização em tempo real à medida que as pessoas entram na fila da mesma forma - todas as características do Adaptador Client-Side são totalmente suportadas. Por favor contacte o suporte se desejar activar as Páginas de Fila Dinâmicas na sua conta.

Adaptador de Rede-Edge Recursos adicionais

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


REST APIs

Queue-Fair dá aos programadores acesso a seis Módulos API REST. Será necessária uma conta Queue-Fair para utilizar o API. Para permitir o acesso API à sua conta, por favor contacte o Suporte Queue-Fair. Os nossos Módulos API REST estão em conformidade com as normas OpenAPI, RFC 7807 e RFC 3339.

O nosso conjunto de Módulos API é abrangente - qualquer coisa que possa fazer no Portal, também pode fazer com a API, excepto gerir Utilizadores do Portal, o que é excluído por razões de privacidade.

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

Módulos API



Páginas Dinâmicas de Fila de Espera

Também pode modificar as suas Páginas de Fila de Espera em tempo real sem ter de actualizar a base de dados utilizando o Portal ou a API de Apresentação - Contacte o Suporte para mais detalhes e para activar as Páginas de Fila Dinâmicas na sua conta.

REST API Recursos adicionais

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


Aplicações nativas

O Queue-Fair fica óptimo em navegadores móveis, bem como em computadores de secretária e portáteis.

Também pode utilizar o Queue-Fair directamente nas suas aplicações nativas iOS e Android, e também aplicações React Native no iOS, Android, Windows e MacOS, para proteger actividades ou operações de recursos intensivos.

Os Adaptadores de Aplicações Queue-Fair utilizam um Cliente Web para ligar aplicações e exibir Filas de espera personalizadas para os seus utilizadores quando os seus serviços estão demasiado ocupados, com a flexibilidade e facilidade de utilização do Queue-Fair Portal.

Pode fazer fila de utilizadores na mesma fila que os visitantes do seu website, ou criar uma fila separada para os utilizadores da sua aplicação - a decisão é sua.

Tal como as nossas filas baseadas na web, uma vez juntadas à fila, o lugar de cada utilizador é automaticamente guardado se também navegar para longe da sua aplicação.

Repositórios GitHub

Notificações em fila

O Adaptador Queue-Fair dispõe de ligações de retorno que facilitam o envio de Notificação de Push aos utilizadores que não estejam a utilizar a sua aplicação ou fila de espera quando a sua vez é chamada. O lugar do utilizador na fila é automaticamente armazenado de forma persistente pelo Adaptador na sua aplicação. Se o utilizador navegar para longe da sua aplicação, a sua aplicação diz ao seu servidor de Notificação Push que deve ser enviada uma notificação, enviando a informação armazenada da posição da fila como parte dessa mensagem para o seu servidor de Notificação Push.

É a mesma tecnologia que usamos para a nossa aplicação e serviço ao consumidor WeQ4U, que já teve cerca de 2 milhões de downloads só no Reino Unido.

O seu servidor de Notificação Push consulta periodicamente a API de estado Queue-Fair para consultar a posição da fila actualmente a ser servida. Quando esta é maior do que a posição de um determinado utilizador na fila, é altura de contactar esse utilizador com a notificação. Se o utilizador regressar à fila ou for Passado antes de uma Notificação Push ter sido enviada, as chamadas no Adaptador notificam a sua aplicação, e a sua aplicação diz ao seu servidor de Notificação Push que a notificação já não é necessária.

Segundo o nosso conhecimento, somos o único fornecedor de Sala de Espera Virtual que apoia esta funcionalidade.

Recursos de Vídeo

Aqui está um vídeo do Adaptador Nativo em acção, mostrando que o lugar do utilizador é guardado mesmo que a aplicação esteja completamente parada, e também mostrando os ganchos do Adaptador que a sua aplicação utiliza para enviar Notificações Push.

Recursos adicionais

Os nossos Adaptadores de Aplicação Nativa são descritos no Guia Técnico. O Guia Técnico está disponível na secção Portal Queue-Fair > Ajuda, ou pode solicitar-nos uma cópia. Pode também encontrar mais informação sobre cada um dos Adaptadores que é específica para iOS e Android no README.md de cada repositório da comunidade global GitHub.


Adaptadores de ECommerce

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

Os nossos Adaptadores estão descritos no Guia Técnico. O Guia Técnico está disponível na secção Portal Queue-Fair > Ajuda, ou pode solicitar-nos uma cópia.

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


Segurança Híbrida

Pode facilmente combinar a flexibilidade do Adaptador JavaScript do lado do cliente com a camada de segurança adicional fornecida pelo nosso código do lado do servidor.

Queue-Fair assina cada visitante que passamos com uma impressão digital que é única para esse Visitante. Única na indústria, a assinatura também inclui código específico do browser do visitante, para evitar que os tokens de acesso sejam partilhados.

O seu servidor web pode validar a assinatura utilizando um segredo conhecido apenas por si e por nós - não pelos seus visitantes - para garantir que cada visitante foi passado de forma justa pelos servidores Queue-Fair.

Assim, pode utilizar o Adaptador JavaScript do lado do Cliente para enviar e receber visitantes de e para a fila de espera, e verificar a existência de adulteração antes de estes encomendarem com um código mínimo do lado do Servidor, e evitar introduzir uma dependência do nosso sistema.

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

Repositórios GitHub

Recursos adicionais

O Modelo de Segurança Híbrido é descrito na íntegra no Guia Técnico. O Guia Técnico está disponível na secção Portal Queue-Fair > Ajuda, ou pode solicitar-nos uma cópia.


Licença

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


Quer saber como funciona o Queue-Fair?