# 电子卡跳转小程序获取成员信息

# 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 找不到对应成员记录