腾讯微卡Wiki

# 小程序打开用户电子卡

小程序打开卡:wx.openCard (opens new window)，需要参数cardList,由本接口返回。cardList是一个数组，当数组元素个数为1时，微信会直接打开当前卡；大于1时，会打开卡列表。

# 1.接口地址

# 请求方法：

GET(application/json)

# 请求地址：

https://weixiao.qq.com/apps/school-api/student-cards

# 2.请求参数

{
    "school_code": "SCHOOL_CODE",
    "card_number": "CARD_NUMBER",
    "timestamp": "TIMESTAMP",
    "nonce": "NONCE",
    "app_key": "APP_KEY",
    "signature": "SINGATURE"
}
字段名 变量名 必填 示例值 类型 说明
主体代码 school_code 是 4111010001 int(10) 主体代码，查看主体代码 (opens new window)
学号 card_number 是 123456778 String 该用户的电子卡号
时间戳 timestamp 是 1514276659 int 当前unix时间戳
随机串 nonce 是 5K8264ILTKCH16CQ2502SI8ZNMTM67VS String(32) 随机字符串
应用key app_key 是 SDFSDFD String(32) 腾讯微卡分配的app_key
签名 signature 是 a790e009d30c09bd8605810eaf9c44b0 String(32) 签名

签名方式：见签名算法 (opens new window)。

# 3.返回数据

# 响应说明：

cards即为小程序所需要的开卡参数

{
    "code": 0,
    "message":'ok',
    "cards": [
        {
            "cardId": '',
            "code": ''
        }, 
        {
            "cardId": '',
            "code": ''
        }
        ...
    ]
}
参数 是否可空 说明
code 非空 返回码（0表示成功）
message 非空 提示信息
cards 可空 小程序所需要的开卡参数
cardId 可空 小程序所需要的开卡参数
code 可空 小程序所需要的开卡参数

# 错误返回：

{
    "code": xxx,(非0错误码)
    "message": xxx,(错误信息)
}

# 4.错误码

名称 解决方案
7002 用户不存在
10005 app_key权限不足
47001 主体不存在