公交卡余额查询接口开放使用啦!
公交卡余额查询 发表于5年前
你可以通过公交卡余额查询接口享用虎泰克产品所使用的余额查询服务
公交卡余额查询Api
API说明
本API返回数据仅支持JSON格式且会对中文进 行unicode
编码,JSON格式返回数据基本格式如下:
{
"errCode": 0,
"errMsg": "OK",
"data": {}
}
其中 errCode
表示请求状态,0表示请求成功, errMsg
为返回信息, data
为请求成功后返回数据;若 errCode
返回不为0,则为对应错误编码, errMsg
为对应错误信息。
注意:
1. 使用本接口时请使用https协议。
2. 使用本接口时请注意控制访问频率,系统限制QPS为1。
3. 本接口仅包含官网返回的基础数据,需解析更多数据请自行处理。
4. 因不可抗拒因素导致的系统停用,导致调用本接口的下游系统出现故障,随风飘扬不负任何责任。
5. 申请密钥请将手机号为主题发送邮件到admin@whutech.com
请求信息
GET https://free-api.whutech.com/release/card
请求参数
参数 | 样例 | 说明 |
---|---|---|
city | wuh | 查询卡号所属交通卡类型, 对应关系见附录 |
cardno | 8123122726 | 查询卡号 |
返回信息
成功响应示例
{
"errCode": 0,
"errMsg": "OK",
"data": {
"cardno": "8123122726",
"balance": 51.3,
"records": [{
"time": "2018-12-20 17:28:51",
"type": "储值钱包一般消费",
"amount": 0,
"balance": 51.3
}, {
"time": "2018-12-20 17:06:28",
"type": "储值钱包一般消费",
"amount": 1.6,
"balance": 51.3
}, {
"time": "2018-12-13 14:12:52",
"type": "储值钱包一般消费",
"amount": 1.6,
"balance": 59.3
}],
"update": "2019年02月01日 00:00:00"
}
}
响应参数
参数 | 类型 | 样例 | 说明 |
---|---|---|---|
cardno | String | 8123122726 | 交通卡号 |
balance | Float | 6 | 卡片当前余额 |
records | Array | [] | 卡片消费记录* |
records.time | String | 2018-12-13 14:12:52 | 消费时间 |
records.type | String | 储值钱包一般消费 | 消费类型 |
records.amount | Float | 1.6 | 消费金额 |
records.balance | Float | 59.3 | 当次刷卡后交通卡剩余金额 |
*若传入的交通卡提供消费记录信息,则接口返回的json内 data
会包含 records
对象,否则 data
仅包含 cardno
, balance
属性
失败响应示例
{
"errCode": "404",
"errMsg": "未能查询到该卡号数据!"
}
附录
交通卡所属代码
参数 | 类型 |
---|---|
pek | 北京市政交通一卡通 |
sha | 上海公共交通卡 |
wuh | 武汉城市一卡通 |
gft | 广佛一卡通 |
szv | 苏州市民卡 |
lnt | 广东岭南通 |
wuh | 武汉一卡通 |
can | 广州羊城通 |
cgo | 郑州绿城通 |
ckg | 重庆畅通卡 |
ctu | 成都天府通 |
tao | 青岛琴岛通 |
tsn | 天津城市通 |
xmn | 厦门E通卡 |
dgm | 东莞通 |
hfe | 合肥通 |
szx | 深圳通 |
hgh | 杭州通 |
作者:@随风飘扬
2019年2月1日
若您觉得好用的话,欢迎扫描下方二维码对我进行赞赏。
+
声明:凡本网转载的文/图等稿件,均出于传递更多信息及方便探讨之目的,并不意味着本站及主办、承办单位赞同其观点或证实其内容的真实性,文章内容仅供参考,如果侵犯了原作者的权利请与网站管理员联系。
阅读 15889