API

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.

Endpoints

Puedes utilizar los siguientes endpoints para hacer una consulta de datos de una tarjeta:

GET/api/v2/tarjeta/{número}

Utiliza este endpoint para solicitar la información completa de la tarjeta y los movimientos.

/api/v2/tarjeta/
Headers
KEYVALORDESCRIPCIÓN
Content-Typeapplication/json;charset=UTF-8Indica el tipo de contenido de la respuesta.
Cache-Controls-maxage=900Indica que la respuesta es almacenada en caché en un proxy. El número indica el tiempo en segundos que la respuesta será almacenada en caché, en este caso 15 minutos.
Age{número}Indica la edad de la respuesta en segundos.
Respuestas

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.

Objetos principales
KEYTIPODESCRIPCIÓN
statusstringSi 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.
tarjetaSaldometrobusTarjeta or nullToda la información de la tarjeta solicitada. Si existe un error, el valor de este objeto será null.
Objetos de tarjeta (SaldometrobusTarjeta)
KEYTIPODESCRIPCIÓN
numerostringEl número de la tarjeta solicitada.
ksistringIdentificador de inicio utilizado por el sitio de consultas http://tarjetametrobus.com.
saldostringSaldo actual en Balboas de la tarjeta solicitada (2 decimales).
estadostringEstado del contrato actual de la tarjeta solicitada.
fechastringLa 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".
tipostringTipo de tarjeta. Por ejemplo: "Tarjeta Rapipass".
movimientosSaldometrobusMovimiento[]Arreglo con información cronológica sobre cada uno de los movimientos de la tarjeta durante las últimas 4 semanas.
Objetos de movimientos (SaldometrobusMovimiento)
KEYTIPODESCRIPCIÓN
transaccionstringNúmero de transacción del movimiento.
tipostringTipo de movimiento o acción realizada por la tarjeta durante fechas determinadas.
fecha_horastringFecha y hora en la que fue realizada dicho movimiento o acción.
montostringMonto de dinero utilizado en su respectiva acción.
saldo_tarjetastringSaldo disponible hasta la fecha del movimiento.
lugarstringLugar donde fue realizado el movimiento o acción.

- Yizack Rangel (yizack.com). Actualizado en 20/10/2023.