随风飘扬

公交卡余额查询接口开放使用啦!

公交卡余额查询Api


    API说明

    本API返回数据仅支持JSON格式且会对中文进 行unicode 编码,JSON格式返回数据基本格式如下:

    1. {

    2.    "errCode": 0,

    3.    "errMsg": "OK",

    4.    "data": {}

    5. }

    其中 errCode 表示请求状态,0表示请求成功, errMsg 为返回信息, data 为请求成功后返回数据;若 errCode 返回不为0,则为对应错误编码, errMsg 为对应错误信息。

    注意: 
    1. 使用本接口时请使用https协议。 
    2. 使用本接口时请注意控制访问频率,系统限制QPS为1。 
    3. 本接口仅包含官网返回的基础数据,需解析更多数据请自行处理。 
    4. 因不可抗拒因素导致的系统停用,导致调用本接口的下游系统出现故障,随风飘扬不负任何责任。

    请求信息

    GET https://free-api.whutech.com/release/balance

    请求参数

    参数样例说明
    citywuh查询卡号所属交通卡类型, 对应关系见附录
    cardno8123122726查询卡号

    返回信息

    成功响应示例

    1. {

    2.    "errCode": 0,

    3.    "errMsg": "OK",

    4.    "data": {

    5.        "cardno": "8123122726",

    6.        "balance": 51.3,

    7.        "records": [{

    8.            "time": "2018-12-20 17:28:51",

    9.            "type": "储值钱包一般消费",

    10.            "amount": 0,

    11.            "balance": 51.3

    12.        }, {

    13.            "time": "2018-12-20 17:06:28",

    14.            "type": "储值钱包一般消费",

    15.            "amount": 1.6,

    16.            "balance": 51.3

    17.        }, {

    18.            "time": "2018-12-13 14:12:52",

    19.            "type": "储值钱包一般消费",

    20.            "amount": 1.6,

    21.            "balance": 59.3

    22.        }],

    23.        "update": "2019年02月01日 00:00:00"

    24.    }

    25. }

    响应参数

    参数类型样例说明
    cardnoString8123122726交通卡号
    balanceFloat6卡片当前余额
    recordsArray[]卡片消费记录*
    records.timeString2018-12-13 14:12:52消费时间
    records.typeString储值钱包一般消费消费类型
    records.amountFloat1.6消费金额
    records.balanceFloat59.3当次刷卡后交通卡剩余金额

    *若传入的交通卡提供消费记录信息,则接口返回的json内 data 会包含 records 对象,否则 data 仅包含 cardno , balance属性

    失败响应示例

    1. {

    2.    "errCode": "404",

    3.    "errMsg": "未能查询到该卡号数据!"

    4. }

    附录

    交通卡所属代码

    参数类型
    pek北京市政交通一卡通
    sha上海公共交通卡
    wuh武汉城市一卡通
    gft广佛一卡通
    szv苏州市民卡
    lnt广东岭南通
    wuh武汉一卡通
    can广州羊城通
    cgo郑州绿城通
    ckg重庆畅通卡
    ctu成都天府通
    tao青岛琴岛通
    tsn天津城市通
    xmn厦门E通卡
    dgm东莞通
    hfe合肥通
    szx深圳通
    hgh杭州通

    作者:@随风飘扬 
    2019年2月1日

    若您觉得好用的话,欢迎扫描下方二维码对我进行赞赏。

    +

    转载请注明: 随风飘扬 » 公交卡余额查询接口开放使用啦!


    登录后可评论,点击前往登陆

    评论列表