腾讯微卡Wiki

# 开启应用

应用开启时，腾讯微卡会对应用接口地址带上type=open参数并发起一个POST请求。应用需要按规定返回，腾讯微卡需要对返回的数据做记录。

# 请求方法：

POST(application/json)

# 请求地址：

https://www.example.com/index?type=open

# 参数说明：

{
    "school_code": "SCHOOL_CODE",
    "host": "https://uni.weixiao.qq.com",
    "gate_host": "GATE_HOST",
    "app_key": "APP_KEY",
    "timestamp": "TIMESTAMP",
    "nonce": "NONCE",
    "signature": "SINGATURE"
}
参数 是否必填 类型 实例 说明
school_code 是 String(128) SCHOOL_CODE 主体代码
host 是 String https://uni.weixiao.qq.com 主体部署域名
gate_host 是 String https://open.wecard.qq.com 网关域名
app_key 是 String 11F7AB57AB3E32D4 应用的appKey
timestamp 是 Integer 1514276659 当前unix时间戳
nonce 是 String 5K8264ILTKCH16CQ2502SI8ZNMTM67VS 32位随机字符串
signature 是 String A790E009D30C09BD8605810EAF9C44B0 按照签名算法生成的签名（参考签名算法）

# 响应说明：

{
    "errcode":0,
    "errmsg":"ok",
    "mnp_qrcode":"https://weixiao.qq.com/upload/mnp_wxacode/fac9b61496923103.jpg",
    "url": "https://weixiao.qq.com",
    "manage_url": "https://weixiao.qq.com"
}
参数 是否必填 类型 实例 说明
errcode 是 Integer 0 状态码，0为成功，非0为失败
errmsg 否 String success 状态描述信息
mnp_qrcode 否 Integer 1514276659 应用小程序码图片地址，小程序类应用为必传字段，该小程序码会作为服务大厅的入口
url 否 String https://weixiao.qq.com 移动端地址
manage_url 否 String https://weixiao.qq.com PC端地址

# 注意事项

  1. 应用需要对签名和时间戳进行验证：开发者根据签名算法计算签名，判断与接收到的签名是否一致，来验证请求来源于腾讯微卡；另外接收到请求时需要判断当前时间戳与接收到的timestamp参数是否在一个合理的范围，以防止重放攻击。
  2. 若跳转到移动端地址，需要获取用户权限，参考文档移动端H5获取用户身份态 (opens new window)。若移动端作为管理端，需要判断用户权限，参考文档获取用户权限信息 (opens new window)
  3. 若跳转到PC端地址，需要获取用户权限，参考文档PC端获取用户身份态 (opens new window)。若PC端作为管理端，需要判断用户权限，参考文档获取用户权限信息 (opens new window)