# 电子卡跳转小程序获取成员信息
# 1.接口地址
# 请求方法:
POST(application/json)
# 请求地址:
https://weixiao.qq.com/apps/school-api/mnp-student
# 2.请求参数
{
"school_code": "SCHOOL_CODE",
"app_key": "APP_KEY",
"timestamp": "TIMESTAMP",
"nonce": "NONCE",
"card_id": "CARD_ID",
"openid": "OPENID",
"encrypt_code": "ENCRYPT_CODE",
"signature": "SINGATURE"
}
字段名 | 变量名 | 必填 | 类型 | 说明 |
---|---|---|---|---|
app_key | app_key | 是 | String(32) | 腾讯微卡分配的app_key |
时间戳 | timestamp | 是 | int | 当前unix时间戳(秒) |
随机串 | nonce | 是 | String(32) | 随机字符串 |
微信电子卡标识 | card_id | 是 | String | 电子卡跳转小程序时带的card_id |
微信标识 | openid | 是 | String(32) | 电子卡跳转小程序时带的openid |
加密体 | encrypt_code | 是 | String(32) | 电子卡跳转小程序时带的encrypt_code |
签名 | signature | 是 | String(32) | 签名 |
获取跳转参数:从卡券跳转小程序后,开发者可以通过app.js 的 onshow的query中或取到发起跳转的card_id、encrypt_code和用户的公众号openid
签名方式:见签名算法 (opens new window)。
# 3.返回数据
# 响应说明:
{
"code": 0,
"message": 'ok',
"name": xxxxx,(姓名)
"card_number": xxxxx,(电子卡号)
"school_code": xxxxx,(主体代码) (该参数在之前版本中曾被命名为 school_id,现已兼容处理)
"school_name": xxxxx,(主体名称)
}
参数 | 是否可空 | 说明 |
---|---|---|
code | 非空 | 返回码(0表示成功) |
message | 非空 | 提示信息 |
name | 可空 | 姓名 |
card_number | 可空 | 电子卡号 |
school_code | 可空 | 主体代码,该参数在之前版本中曾被命名为 school_id,现已兼容处理 |
school_name | 可空 | 主体名称 |
# 错误返回:
{
"code": xxx,(非0错误码)
"message": xxx,(错误信息)
}
# 4.错误码
名称 | 解决方案 |
---|---|
10005 | key权限不足,无法查询该用户信息 |
42007 | 该电子卡不存在 |
42008 | 加密体无法解密 |
42009 | 网络错误 |
43001 | 找不到对应主体 |
44002 | 找不到对应用户记录 |