# 开启应用

应用开启时,腾讯微卡会对应用接口地址带上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)