Flying in the wind

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

公交卡余额查询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日

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

    +

    Statement: all articles / drawings reproduced on this website are for the purpose of transmitting more information and facilitating discussion, which does not mean that the website, the host and the organizer agree with their opinions or confirm the authenticity of their contents. The contents of the articles are for reference only. If the rights of the original author are violated, please contact the website administrator.

    Reprint please indicate: Flying in the wind » 公交卡余额查询接口开放使用啦!


    Sign in to comment

    Comment list