# 用户校园卡面余额字段同步


校园卡余额信息同步由认证方提供接口,腾讯微卡根据需求定期拉取数据;

# 1. 请求方式

腾讯微卡采用POST的方式向认证方发送application/json请求。

# 2. 请求参数

腾讯微卡请求原始数据 R(即电子卡号/学工号组成的数组):

{
    "cards": [
        "123456789",
        "234567891",
        ...
    ]
}

通过加密R可以得到R'R' = AES_CBC_ENCRYPT(R)

{
    "raw_data":R',
    "app_key":APP_KEY
}

腾讯微卡会把加密后的数据以POST的方式发送到认证方提供的数据接口。

# 3. 数据返回

返回数据:

{
    "code":0,
    "message":"success",
    "raw_data":R',
    "app_key":APP_KEY
}

校方返回数据解密后示例:

[
    {
        "card_number": "123456789",
        "value": 192.01
    },
    {
        "card_number": "123456789",
        "value": 0
    },
    ...
]

其中: value即为显示在校园卡余额信息项上的内容

注意:

  • 1,接口开发完后可以到腾讯微卡进行自助调试,地址:https://weixiao.qq.com/public/apiDebug/index.html ;
  • 2,腾讯微卡保证请求校园卡余额字段数据的频率每秒不超过10次,每次不超过100张卡,校方须有相应的承载能力;

# 附件

# 1 数据加密

采用AES对称加密算法(AES/CBC/ZeroPadding 128位模式),具体算法见加解密demo

KEY = APP_KEY
IV = APP_SECRET 前16位。

APP_KEY和APP_SECRET的获取见接口对接指引