API

La API de solicitud de código de login se implementa en todas las versiones de firmware GIS y está disponible para proveedores de PoS y otros integradores de sistemas.

El firmware GIS incluye un firewall desde la DMZ a la red privada para garantizar el cumplimiento de las recomendaciones PCI-DSS.

El firewall impide el acceso público de DMZ a la subred privada, lo que protege la información confidencial almacenada en las computadoras PoS.

Los gateway GIS tienen cuatro puertos LAN para conectar dispositivos DMZ.

La API tiene tres funciones separadas:

  • Generar uno o más códigos (hasta el límite permitido por el gateway)
  • Lista de códigos de login disponibles en el gateway con el estado de cada
  • Eliminar códigos y eliminar de la base de datos

Crear códigos

Los códigos se pueden agregar al sistema a través de una sola llamada HTTP, la URL es:
http://aplogin.com/codes/makecode.cgi

La contraseña para los códigos debe crearse primero en:
http://aplogin.com/admin/password.cgi

Si no ha iniciado sesión en la interfaz de códigos en http://aplogin.com/codes, la contraseña debe pasarse como argumento:
http://codes:password@aplogin.com/codes/makecode.cgi

La IP del dispositivo GIS también se puede usar en lugar del nombre de host.

Los parámetros a pasar se muestran en la siguiente tabla:

Parámetro
Valores
Comentarios
code Crea un nombre para el código Argumento opcional y no es necesario para la llamada
num Número de códigos para crear El argumento debe estar incluido en la llamada.
El número máximo de códigos está limitado por los códigos disponibles
time Tiempo en minutos El argumento debe estar incluido en la llamada
type Tipo de códigos:
n=usuario normal/único
m=uso múltiple
El argumento debe estar incluido en la llamada
download Límite de descarga (kbps) Argumento opcional y no es necesario para la llamada
upload Límite de subida (kbps) Argumento opcional y no es necesario para la llamada
downlimit Límite de descarga de datos (Mbps) Argumento opcional y no es necesario para la llamada
uplimit Límite de subida de datos (Mbps) Argumento opcional y no es necesario para la llamada


Un ejemplo de llamada para crear un código de usuario único con una duración de 30 minutos:
http://aplogin.com/codes/makecode.cgi?num=1&time=30&type=n

La llamada API devolverá un nuevo código que está listo para usar o un error; los posibles errores se enumeran a continuación:

  • ERROR: Parámetros inválidos
  • ERROR: No se pueden crear más de XX códigos
  • ERROR: Tipo de código no válido
  • ERROR: Tiempo del código no válido
  • ERROR: Límite de subida de código no es válido
  • ERROR: Límite de descarga de código no es válido

Eliminar códigos

Los códigos se pueden eliminar del sistema a través de una sola llamada HTTP, la URL a utilizar es:
http://aplogin.com/codes/deletecode.cgi

Los parámetros a pasar incluye:

Parámetro
Valores
Comentarios
code Código a eliminar El argumento debe estar incluido en la llamada


Un ejemplo de llamada para eliminar el código 876DTW: http://aplogin.com/codes/deletecode.cgi?code=876DTW

La llamada API devolverá OK o un error; los posibles errores se enumeran a continuación:

  • ERROR: Parámetros inválidos
  • ERROR: El código no existe
  • ERROR: No se puede eliminar el código

Visualizar los códigos

Los códigos no se pueden probar individualmente, pero se puede hacer una llamada para enumerar todos los códigos en el sistema, entonces depende del software que está haciendo la llamada API para analizar los datos devueltos y presentarlos en el formato requerido por el usuario o realizar cualquier búsqueda o prueba requerida en un código.

Se puede obtener una lista de códigos del sistema a través de una sola llamada HTTP, la URL a utilizar es:
http://aplogin.com/codes/showcode.cgi

No hay parámetros que pasar para esta llamada API.

La llamada API devolverá una lista de códigos o un mensaje de error, la lista de códigos se presenta en un formato delimitado por tabulaciones (\t) con una fila de encabezado.

CÓDIGO TIEMPO TIPO USADO RESTANTE DESCARGA SUBIDA
113DRW 2 n Yes Expired * *
1AT1AQ 30 t No 30 * 100
3B0AQ0 2 n Yes Expired * *
61QG8G 30 t No 30 * *
8CWJLE 30 n No 30 * *
94KH4E 30 n No 30 * *
ARLGH0 30 m No 30 * *
BJKBH7 2 n Yes Expired * *
M47TGF 32 t No 32 * 999
WY7W0R 2 t No 2 * 999


Obtener la lista de MAC permitidos

http://aplogin.com/admin/macmanage.cgi?list=allowed

Obtener una lista de MAC bloqueados

http://aplogin.com/admin/macmanage.cgi?list=blocked

Bloquear un MAC

La dirección MAC debe escribirse en formato separado por dos puntos.
http://aplogin.com/admin/macmanage.cgi?mac=00:11:22:33:44:55&action=block

Permitir un MAC

La dirección MAC debe escribirse en formato separado por dos puntos.
http://aplogin.com/admin/macmanage.cgi?mac=00:11:22:33:44:55&action=allow

Habilitar Administración Remota

La administración remota se puede habilitar sustituyendo aplogin.com por la dirección IP del gateway.