# 小程序打开用户电子卡
小程序打开卡: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 | 主体不存在 |