API

Desarrolladores

Conecte su propia aplicación con los datos de sus impresoras y actualícela en tiempo real con las APIs o directamente con la base de datos.

code

API

Puede utilizar un servicio web para extraer los datos de su aplicación. Podemos establecer una consulta específica para usted para que pueda extraer los datos que necesita.

MySQL

Puede acceder directamente a la base de datos MySQL. Te daremos acceso y soporte para realizar cualquier consulta. También puede escribir un estado en un flag en algunas tablas.

API para hacer 'pulling' contra la base de datos.

GET / Últimas lecturas de contadores de todas las impresoras.

Variables

Campo
Descripción Ejemplo
IP /Dominio
Subdominio o dirección IP
https://app.ameterreading.com/web_app/api_v1/
Query name
Nombre asociado a una consulta MySQL y el formato del archivo. Puede solicitar otra consulta con más campos o incluso otros diferentes.
meters_json.php
Token ID
Es un número para identificar al usuario. Está asociado a una licencia. También se puede asociar a un código de cliente y un código de instalación.
?token=453FF0945D20D3F8416FF81163394BD0
Client code
Código de cliente. Cuando el token no tiene asociado un cliente por defecto, con el mismo token se pueden capturar los datos de todos los clientes. Si en el link se indica un código de cliente, se listaran solo los equipos que correspondan a dicho cliente. Si este valor no esta o está en blanco, se listarán todos los equipos. 
&code=test_1234
Install  code
Código de instalación. Funciona igual que el código de cliente. Un mismo cliente puede tener diversas instalaciones. Indicando el código de instalación, solo aparecerás los equipos correspondientes a este. Seria el caso de un cliente con varias sedes.  
&codinstall=FA-16-3E-B1-A7-EE

Campos resultado como muestra

Campo
Descripción Ejemplo
iKey
ID único de la impresora ZCZBBJCG6001FJW-ci-FA-16-3E-B1-A7-EE
Install
Código de instalación
FA-16-3E-B1-A7-EE
Icon
Icono asociado
0
Billable Impresora con contrato / facturable on
Code
Código de cliente 865975
Date
Fecha formato largo
2020-10-26 09:21:05
Serial
Número de serie
ZCZBBJCG6001FJW
Alias
Alias de la impresora
Any number or name
Model
Modelo
KONICA MINOLTA bizhub C250i
BW
Contador impresiones en negro 
9999
Color
Contador impresiones en color
9999
Total
Contador impresiones totales
9999
A3_BW
Contador impresiones en negro Din A3
9999
A3_Color
Contador impresiones en color Din A 3
9999
Scans
Contador escaneos
9999
Status
Estado impresora. 9999
Location
Localización de la impresora dentro del cliente 9999
K
Nivel tóner negro
0
C
Nivel tóner cían
10
M
Nivel tóner magenta
50
Y
Nivel tóner amarillo
100

Ejemplo de código

Formato: Specific URL+ SQL query ID + token ID  

Ejemplo explicado: https://app.ameterreading.com/web_app/api_v1/" + "meters_json.php" + "?token=453FF0945D20D3F8416FF81163394BD0” + "&code=test_1234" + "&codinstall=FA-16-3E-B1-A7-EE"

Test URL ( 1 token por cliente )

https://app.ameterreading.com/web_app/api_v1/meters_json.php?token=453FF0945D20D3F8416FF81163394BD0

Test URL ( 1 token para todos los clientes )

https://app.ameterreading.com/web_app/api_v1/meters_json_2.php?token=453FF0945D20D3F8416FF81163394BD0&code=test_1234&codinstall=10-E7-C6-2A-E9-60

Ejemplo de resultado (json)

{"total":2,"rows":[

{"iKey":"9C-32-CE-01-48-85-ci-F4-B7-E2-8E-AE-E9","Install":"F4-B7-E2-8E-AE-E9","Icon":"","Billable":"on","Code":"CL-7787","Date":"2020-09-15 16:23:26","Serial":"2GE03028","Alias":"","Model":"Canon iR-ADV C3525 III 11.20","BW":"5760","Color":"3470","Total":"9279","A3_BW":"8","A3_Color":"41","Scans":"1295","Status":"OK","Location":null,"K":"16","C":"1","M":"1","Y":"1"},

{"iKey":"JWF60669-ci-00-16-44-D5-F4-2D","Install":"00-16-44-D5-F4-2D","Icon":"","Billable":"on","Code":"7654321","Date":"2020-10-22 10:13:38","Serial":"JWF60669","Alias":"","Model":"Canon iR-ADV C5235 46.68","BW":"42055","Color":"95454","Total":"144450","A3_BW":"657","A3_Color":"6284","Scans":"18201","Status":"OK","Location":"","K":"82","C":"10","M":"19","Y":"5"}

]}