Recursos para desarrolladores



Añadir Queue-Fair

La sala de espera virtual Queue-Fair se añade fácilmente a una amplia variedad de plataformas web y aplicaciones en cuestión de minutos. Sólo tiene que utilizar uno de nuestros adaptadores. Puede encontrar más información sobre la mejor forma de integrar el servicio Queue-Fair con su sistema actual en la Guía técnica o en la sección Portal Queue-Fair > Ayuda. Si está buscando información sobre cómo impedir que los bots o los humanos realicen varios pedidos, o proteger sus ventas NFT de las excesivas tasas de gas, puede leer este resumen u obtener todos los detalles en la sección Guía de seguridad del Portal.

La forma más rápida de empezar a utilizar Queue-Fair es registrar una cuenta Nivel gratuito puede hacerlo en línea ahora y empezar a integrar y probar inmediatamente.

¿Necesita ayuda para establecer las tarifas de su cola? Todo lo que necesita saber está aquí.

El adaptador del lado del cliente

Para los sitios web, la forma más sencilla de integrarse con Queue-Fair es añadir la etiqueta JavaScript del Adaptador Queue-Fair del lado del cliente a sus páginas. Puede añadir con seguridad el Adaptador a todas las páginas de su sitio, y utilizar las Reglas de Activación en el Portal de Q FXNPQ para determinar qué páginas pueden lanzar una cola.

Nuestro adaptador JavaScript del lado del cliente es más seguro que las piezas de integración del lado del cliente de otros proveedores. Dado que se ejecuta en los navegadores de sus visitantes, el adaptador del lado del cliente puede ser manipulado por visitantes con conocimientos técnicos, pero es muy eficaz para evitar la sobrecarga, ya que sólo una minoría muy pequeña de personas intentará saltarse la cola manipulando el JavaScript. La mayoría de nuestros clientes utilizan el adaptador del lado del cliente porque es eficaz para evitar que se bloquee el sitio, es fácil de instalar y no introduce ninguna dependencia entre nuestro sistema y el suyo. A diferencia de las piezas de integración del lado del cliente de otros proveedores, puede hacerse a prueba de manipulaciones con el Modelo de Seguridad Híbrido descrito en la Guía Técnica.

Puede añadir una capa de seguridad sustituyendo la etiqueta JavaScript por un adaptador del lado del servidor, o combinar la flexibilidad del adaptador JavaScript con el modelo de seguridad híbrido descrito en esta página; ambos métodos son entonces seguros.

Una sola línea de código

Para añadir el adaptador del lado del cliente a su sitio web, sólo tiene que añadir la siguiente línea de código al archivo <head> de sus páginas:

la comunidad global excluye los impuestos ordenar el precio del sistema de colas para los plugins de wordpress

Algunos clientes añaden la palabra defer a la etiqueta, lo que hace que el script del Adaptador se descargue paralelamente al análisis de la página y que sólo se inicie la ejecución del script en el navegador del visitante cuando la página haya terminado de analizarse (por lo tanto, normalmente después de que cualquier otro script de su página haya terminado).

Añadir la palabra aplazar puede mejorar el Tiempo a la Primera Pintura en una pequeña fracción de segundo en algunos casos, pero si decide hacer esto significará que cualquier visitante que deba estar en cola verá su página protegida durante una fracción de segundo más antes de ser enviada a la cola.

Google Tag Manager

También proporcionamos la etiqueta adaptadora de JavaScript a través de Google Tag Manager. Busque Queue-Fair en la Galería de plantillas de la comunidad, en Añadir etiqueta. Tenga en cuenta que algunos bloqueadores de anuncios impiden la descarga del maestro gtm.js de Google, lo que bloquea todas las operaciones de Google Tag Manager, incluida la ejecución del Adaptador del sistema de colas para esos visitantes.

wordpress plugins wp cron gran herramienta para la búsqueda de wordpress y los puestos de la comunidad del sitio a un gran precio

Repositorios de GitHub

wordpress tareas propiedad plugin para crear dólares de datos no php requerido

Google Tag Manager

El repositorio de GitHub para la etiqueta del adaptador del lado del cliente de Google Tag Manager Queue-Fair Virtual Waiting Room.

Páginas de cola dinámicas

Cualquier dato que desee se puede pasar desde su sitio a nuestro sistema de colas y a las páginas de colas que ven sus visitantes utilizando el atributo data-queue-fair-extra que está disponible en la etiqueta JavaScript del lado del cliente y en la implementación de Google Tag Manager. Póngase en contacto con el servicio de asistencia técnica si desea habilitar las páginas de cola dinámicas en su cuenta.

Puede utilizar esta función para personalizar las páginas de la cola sobre la marcha. También puede utilizar Queue-Fair para pasar los datos que nos envíe con sus visitantes de vuelta a su sitio cuando pasen por la cola, para una capa adicional de seguridad.

También proporcionamos una API de página de cola dinámica que utiliza los datos adicionales para personalizar cualquier aspecto de una página de cola, por lo que puede crear una cola para todo su sitio y personalizarla automáticamente para diferentes eventos o productos en su sitio, sin tener que hacer ningún cambio en sus páginas de cola en el portal de Queue-Fair.



Gestión de colas en Shopify, WooCommerce y Wordpress

Si está utilizando un sitio basado en Wordpress, como el sistema de carrito de compras WooCommerce, puede añadir fácilmente la etiqueta Client-Side JavasScript Adapter utilizando el plugin Wordpress Insert Headers & Footers, sin tener que modificar ninguno de sus temas o plantillas ni tocar ningún código de Wordpress.

Sólo tienes que descargar el plugin Insert Headers & Footers, descomprimirlo en tu carpeta /wp-content/plugins/, activar el plugin en el menú Plugins, abrir el plugin desde el menú Settings, añadir la etiqueta a Scripts in Header como se muestra, pulsar Save en la parte inferior de la página, ¡y ya está! La gestión de colas en Wordpress se ha simplificado. Hay otros plugins de Wordpress que puedes usar para añadir la etiqueta también - este es el más popular.

A algunos clientes de Wordpress les gusta añadir la etiqueta JavaScript Queue-Fair a sus páginas de error de Wordpress también, lo que puedes hacer editando /wp-includes/functions. php - añádelo al HTML contenido dentro de la función _default_wp_die_handler en ese archivo.

Shopify es igual de fácil - aquí están las instrucciones para agregar el adaptador JavaScript del lado del cliente Queue-Fair a su tienda Shopify - utilice los tres puntos en la parte superior izquierda después de golpear Personalizar para editar el código en su archivo theme.liquid Layout.

Las marcas se unen a las plantillas para el control de las llamadas de fondo en el punto

Sala de espera virtual SquareSpace del lado del cliente

El Adaptador de JavaScript del lado del cliente también es muy fácil de añadir a su sitio SquareSpace - inicie sesión y seleccione su sitio web, a continuación, Sitio Web de la izquierda nav, Herramientas del Sitio Web (en la sección de Utilidades en la izquierda nav), Inyección de código, y luego copiar y pegar en el cuadro de cabecera, a continuación, Guardar en la parte superior izquierda.

Para obtener la máxima seguridad en SquareSpace, utilice nuestro Adaptador SquareSpace Network-Edge, que se describe a continuación.


Recursos adicionales del adaptador del lado del cliente

El adaptador del lado del cliente se describe completamente en la Guía Técnica. La Guía Técnica está disponible en el Portal Queue-Fair > sección de Ayuda, o puede solicitarnos una copia.


Adaptadores del lado del servidor

Mientras que el adaptador del lado del cliente se ejecuta en JavaScript en los navegadores de sus visitantes, los adaptadores del lado del servidor de Queue-Fair se ejecutan en su servidor web.Esto significa que sus servidores pueden enviar visitantes a la cola de forma más eficiente. Los actores maliciosos no verán el contenido de su sitio, sin embargo, los bots todavía pueden hacer peticiones a sus servidores, por lo que para una protección DDoS completa, utilice uno de nuestros Adaptadores de Red a continuación.

Adaptadores para servidores web

Esto significa que su servidor web puede aprovechar las características de seguridad adicionales para denegar el acceso a las personas que no han sido puestas en cola. Esto también significa que su servidor web evita la carga de generar y servir páginas que contienen el script del Adaptador.

La adición de las bibliotecas del Adaptador del lado del servidor de Queue-Fair sólo lleva unos minutos con cambios mínimos en el código para activar y ejecutar el Adaptador.

La mayoría de nuestros clientes comienzan con el Adaptador JavaScript del lado del cliente y pasan al Adaptador del lado del servidor sólo cuando hay una funcionalidad específica o una necesidad empresarial.

Modo sencillo y seguro

Los adaptadores del lado del servidor Queue-Fair pueden funcionar en modo simple o seguro.

En el modo simple, todos los visitantes son enviados a los servidores Queue-Fair para ser contados, se haya formado o no una cola. Cuando hay una cola, se unen a ella. Cuando no hay cola, son devueltos a su Servidor Web directamente, sin ver una Página de Cola - pero con la firma que su Servidor Web necesita para asegurar que sólo las personas que han sido pasadas por la cola puedan acceder a sus recursos protegidos.

En el Modo Seguro, los visitantes sólo son enviados a los Servidores Queue-Fair cuando hay una Cola. Su servidor web consulta directamente a nuestros servidores de colas en segundo plano para tomar esta determinación. Los visitantes siguen estando firmados digitalmente de forma segura tanto si se unen a una cola como si pasan sin ver una página de cola porque ésta está vacía.

El modo seguro se recomienda para las colas del día a día. El modo simple es apropiado para un evento o venta cronometrada cuando se esperan miles de personas, ya que elimina la latencia debida a la llamada de comprobación desde su servidor web a nuestros servidores de colas, lo que significa que puede enviar a las personas a unirse a la cola de forma más eficiente.

Repositorios de GitHub



Páginas de cola dinámicas

Al igual que con el Adaptador del lado del cliente, cualquier dato que desee puede pasar de su servidor web a nuestros servidores y a las páginas de cola que ven sus visitantes, pasando esta información en la llamada del Adaptador del lado del servidor a medida que las personas se unen a la cola. Esto facilita la personalización de las páginas de cola dinámicas u otras personalizaciones sobre la marcha de la misma manera - todas las características del adaptador del lado del cliente son totalmente compatibles. Póngase en contacto con el servicio de asistencia técnica si desea activar las páginas de cola dinámicas en su cuenta.

Recursos adicionales del adaptador del lado del servidor

Nuestros adaptadores del lado del servidor se describen completamente en la Guía Técnica. La Guía Técnica está disponible en el Portal Queue-Fair > sección de Ayuda, o puede solicitarnos una copia. También puedes encontrar más información sobre cada uno de los Adaptadores en el README.md de cada repositorio de la comunidad global de GitHub.


Adaptadores de red

Los adaptadores de red Queue-Fair se ejecutan dentro del marco de su CDN o proveedor de servicios en la nube, en lugar de en los navegadores de los visitantes o en su servidor de origen. Esta es la mejor manera de utilizar Queue-Fair para proteger sus servidores de ataques de bots, incluyendo ataques DDoS.

Adaptadores de proveedores de Lambda y CDN

Esto proporciona la misma funcionalidad y seguridad que el adaptador del lado del servidor y la misma protección de carga que Direct Link.

La adición de las bibliotecas de Queue-Fair Network-Edge Adapter solo requiere unos minutos con mínimos cambios de código en su proveedor de la nube para activar y ejecutar el Adapter, que normalmente se implementa como una función Lambda o Edge Worker.

Modo sencillo y seguro

Al igual que nuestros adaptadores del lado del servidor, nuestros adaptadores del lado de la red pueden funcionar en modo simple o seguro.

Adaptadores disponibles



Páginas de cola dinámicas

Al igual que con el Adaptador del lado del cliente, se puede pasar cualquier dato que desee desde su sitio a nuestros servidores y a las páginas de cola que ven sus visitantes, pasando esta información en la llamada al Adaptador. Esto facilita la página de cola dinámica u otras personalizaciones sobre la marcha, ya que los usuarios se unen a la cola de la misma manera: todas las funciones del adaptador del lado del cliente son totalmente compatibles. Póngase en contacto con el servicio de asistencia técnica si desea activar las páginas de cola dinámicas en su cuenta.

Adaptador de red Recursos adicionales

Nuestros adaptadores Network-Edge se describen completamente en la Guía Técnica. La Guía Técnica está disponible en el Portal Queue-Fair > sección de Ayuda, o puede solicitarnos una copia. También puede encontrar más información sobre cada uno de los Adaptadores en el README.md de cada repositorio de la comunidad global de GitHub.


APIs REST

Queue-Fair ofrece a los desarrolladores acceso a seis módulos API REST. Necesitará una cuenta Queue-Fair para utilizar la API. Para habilitar el acceso a la API para su cuenta, póngase en contacto con el servicio de asistencia de Queue-Fair. Nuestros módulos API REST cumplen con los estándares OpenAPI, RFC 7807 y RFC 3339.

Nuestro conjunto de módulos API es muy completo: todo lo que puede hacer en el Portal, también lo puede hacer con la API, excepto la gestión de los usuarios del Portal, que está excluida por razones de privacidad.

Cada módulo de la API está completamente documentado en api.queue-fair.net, donde también encontrará una interfaz Swagger para facilitar el uso y las pruebas. Por seguridad, todas las llamadas a la API están protegidas por un cifrado TLS seguro y requieren una clave de API específica para su cuenta.

Módulos API



Páginas de cola dinámicas

También puede modificar sus páginas de cola sobre la marcha sin tener que actualizar la base de datos utilizando el Portal o la API de presentación - Póngase en contacto con el servicio de asistencia para obtener más detalles y para activar las páginas de cola dinámicas en su cuenta.

Recursos adicionales de la API REST

Tal y como exige el RFC 7807, puede encontrar documentación sobre los mensajes de error que pueden devolver nuestros módulos API REST en queue-fair.com/api-error


Aplicaciones nativas

Queue-Fair se ve muy bien tanto en los navegadores móviles como en los ordenadores de sobremesa y portátiles.

También puede utilizar Queue-Fair directamente en sus aplicaciones nativas de iOS y Android, y también en las aplicaciones de React Native en iOS, Android, Windows y MacOS, para proteger las actividades u operaciones que consumen muchos recursos.

Los adaptadores de aplicaciones Queue-Fair utilizan un WebClient para conectar aplicaciones y mostrar pantallas de cola personalizadas a sus usuarios cuando sus servicios están demasiado ocupados, con la flexibilidad y facilidad de uso del Queue-Fair Portal.

Puede poner a los usuarios en la misma cola que a los visitantes de su sitio web, o establecer una cola separada para los usuarios de su aplicación; usted decide.

Al igual que nuestras colas basadas en la web, una vez que se han unido a la cola, el lugar de cada usuario se guarda automáticamente si también navegan fuera de su aplicación.

Repositorios de GitHub

Notificaciones de colas

El Adaptador Queue-Fair tiene callbacks que facilitan el envío de notificaciones push a los usuarios que no están utilizando su aplicación o cola cuando se llama su turno. El lugar del usuario en la cola es automáticamente almacenado de forma persistente por el Adaptador en su aplicación. Si el usuario se aleja de su aplicación, su aplicación le dice a su servidor de notificaciones push que se debe enviar una notificación, enviando la información de la posición en la cola almacenada como parte de ese mensaje a su servidor de notificaciones push.

Es la misma tecnología que utilizamos para nuestra aplicación y servicio para consumidores WeQ4U, que ha tenido alrededor de 2 millones de descargas sólo en el Reino Unido.

Su servidor de notificaciones push consulta periódicamente la API de estado de Queue-Fair para consultar la posición en la cola que se está sirviendo actualmente. Cuando ésta es mayor que la posición en la cola de un usuario concreto, es el momento de contactar con ese usuario con la notificación. Si el usuario vuelve a la cola o se pasa antes de que se haya enviado una notificación push, las devoluciones de llamada del adaptador notifican a su aplicación, y ésta le dice a su servidor de notificaciones push que la notificación ya no es necesaria.

Por lo que sabemos, somos el único proveedor de salas de espera virtuales que admite esta función.

Recursos de vídeo

Aquí hay un video del Native App Adapter en acción, mostrando que el lugar del usuario se guarda incluso si la aplicación está completamente detenida, y también mostrando los ganchos del Adapter que su aplicación utiliza para enviar notificaciones push.

Recursos adicionales

Nuestros adaptadores de aplicaciones nativas se describen en la Guía Técnica. La Guía Técnica está disponible en el Portal Queue-Fair > sección de Ayuda, o puede solicitarnos una copia. También puede encontrar más información sobre cada uno de los adaptadores que es específica para iOS y Android en el README.md de cada repositorio de la comunidad global de GitHub.


Adaptadores de comercio electrónico

Queue-Fair puede añadirse fácilmente a cualquier sistema de comercio electrónico utilizando el adaptador JavaScript del lado del cliente descrito anteriormente.

También ofrecemos un código adaptador para trabajar en el lado del servidor con muchos servidores populares de comercio electrónico.

Repositorios de GitHub

Recursos adicionales

Nuestros adaptadores se describen en la Guía Técnica. La Guía Técnica está disponible en el Portal Queue-Fair > sección de Ayuda, o puede solicitarnos una copia.

También disponemos de Guías complementarias para la mayoría de las plataformas de comercio electrónico, sólo tiene que solicitar la que desee.


Seguridad híbrida

Puede combinar fácilmente la flexibilidad del adaptador JavaScript del lado del cliente con la capa de seguridad adicional que proporciona nuestro código del lado del servidor.

Queue-Fair firma a cada visitante que pasamos con una huella digital que es única para ese visitante. De manera única en la industria, la firma también incluye un código específico para el navegador del visitante, para evitar que los tokens de acceso sean compartidos.

Su servidor web puede validar la firma utilizando un secreto conocido sólo por usted y por nosotros -no por sus visitantes- para garantizar que cada visitante ha pasado limpiamente por los servidores de Queue-Fair.

Por lo tanto, puede utilizar el adaptador JavaScript del lado del cliente para enviar y recibir visitantes desde y hacia la cola, y comprobar si hay manipulación antes de que pidan con un código mínimo del lado del servidor, y evitar introducir una dependencia en nuestro sistema.

En nuestros repositorios de la comunidad global de GitHub se incluye código de ejemplo en todos los principales lenguajes de programación web.

Repositorios de GitHub

Recursos adicionales

El Modelo de Seguridad Híbrido se describe completamente en la Guía Técnica. La Guía Técnica está disponible en el Portal Queue-Fair > sección de Ayuda, o puede solicitarnos una copia.


Licencia

Nuestro código publicado, disponible en el repositorio GitHub Queue-Fair, cuenta con la licencia MIT, que se encuentra entre las más permisivas de las licencias de código abierto para la comunidad mundial.


¿Quieres saber cómo funciona Queue-Fair?