Saltar al contenido principal

People Forwarder SDK

SDK para redireccionar personas a la fila virtual en caso de sobrecarga del sistema.

Instalación​

composer require virtual-queue/people-forwarder

Recomendaciones​

Inicializá el SDK en el punto más alto posible del flujo de ejecución, antes de cualquier lógica, consulta o procesamiento.

El objetivo es que el redireccionamiento ocurra como la primera —o una de las primeras— acciones del sistema para evitar lo máximo posible cualquier carga. Por ej. en Laravel podes insertarlo en bootstrap/autoload.php

#index.php
require_once './vendor/autoload.php';
use VirtualQueue\PeopleForwarder\PeopleForwarder;
$forwarder = new PeopleForwarder('tuticketera', '123456');
$forwarder->forward();

Activación / Desactivación (API del lado de ticketera)​

Crear un API endpoint del lado de la ticketera con una logica similar a la siguiente:

<?php
require_once './vendor/autoload.php';

use VirtualQueue\PeopleForwarder\PeopleForwarder;
use VirtualQueue\PeopleForwarder\Exception\SdkException;

$action = $_GET['action']; //activate|deactivate
$timestamp = $_GET['timestamp'];
$signature = $_GET['signature'];

$forwarder = new PeopleForwarder('tuticketera', 'private_key');
// 'tuticketera' es el subdominio dentro de virtual-queue. Ej. https://tuticketera.virtual-queue.com

try {
    $forwarder->dispatchAction($action, $signature, $timestamp);
}   catch (SdkException $e) {
    echo $e->getMessage();
}

Docker​

Podes verlo implementado y corriendo en esta imagen de docker:

docker run -p 80:80 tu-host/virtual-queue-people-forwarder

API​

http://localhost/api.php?action=activate&timestamp=x&signature=x

Un error de firma invalida sera mostrado pero tambien se proporcionaran datos validos para la prueba. Tenes 5 minutos para usarlos.

Prueba de redirección​

Podes usar la siguiente URL para chequear la redirección.

http://localhost/redirect.php

Licencia​

MIT