Importante: Esta no es una API oficial.
Los puntos finales de la API web de Saldo Metrobús devuelven datos JSON sobre las tarjetas de metro o metrobús de Panamá, extraídos directamente de la página http://tarjetametrobus.com para facilitar el manejo de estos datos.
La dirección base de la API web es https://saldometrobus.yizack.com/api. La API proporciona un conjunto de puntos finales, cada uno con su propia ruta única utilizando el número que se encuentra impreso en las tarjetas brindando acceso a datos como número de la tarjeta, ksi (identificador de sesión), saldo actual de la tarjeta, fecha del saldo, tipo de tarjeta y movimientos de la tarjeta.
Puedes utilizar los siguientes links para hacer una consulta de datos de una tarjeta:
https://saldometrobus.yizack.com/api/v2/tarjeta/{número de tarjeta}. Utiliza esta dirección para solicitar la información completa de la tarjeta y los movimientos.
La API web devuelve todos los datos de respuesta como un objeto JSON. A continuación se muestran tablas con la descripción de todos los objetos recuperables.
| KEY | TIPO | DESCRIPCIÓN |
|---|---|---|
| status | string | Si existe un error, el valor de este objeto será "error", de otro modo el valor del objeto será "ok" para indicar que no existe ningún error. |
| tarjeta | arreglo de strings | Toda la información de la tarjeta:
"numero",
"ksi",
"saldo",
"estado",
"fecha",
"tipo" y
"movimientos".
|
| KEY | TIPO | DESCRIPCIÓN |
|---|---|---|
| numero | string | El número de la tarjeta solicitada. |
| ksi | string | Identificador de inicio utilizado por el sitio de consultas http://tarjetametrobus.com. |
| saldo | string | Saldo actual en Balboas de la tarjeta solicitada (2 decimales). |
| estado | string | Estado del contrato actual de la tarjeta solicitada. |
| fecha | string | La fecha del saldo de la tarjeta está dada por el último movimiento o acción realizada con la tarjeta. Fecha en formato "dd/MM/yyyy". |
| tipo | string | Tipo de tarjeta. Por ejemplo: "Tarjeta Rapipass". |
| movimientos | arreglo de objetos | Información cronológica sobre los movimientos de la tarjeta durante las últimas 4 semanas:
"tipo",
"fecha_hora",
"monto" y
"saldo_tarjeta".
|
| KEY | TIPO | DESCRIPCIÓN |
|---|---|---|
| tipo | string | Tipo de movimiento o acción realizada por la tarjeta durante fechas determinadas. |
| fecha_hora | string | Fecha y hora en la que fue realizada dicho movimiento o acción. |
| monto | string | Monto de dinero utilizado en su respectiva acción. |
| saldo_tarjeta | string | Saldo disponible hasta la fecha del movimiento. |
Nota: Por seguridad de los usuarios, esta API no devuelve los lugares donde se realizaron los movimientos o acciones de la tarjeta.