checkSessionKey

校验服务器所保存的登录态 session_key 是否合法。为了保持 session_key 私密性，接口不明文传输 session_key，而是通过校验登录态签名完成。

请求地址

  1. GET https://api.weixin.qq.com/wxa/checksession?access_token=ACCESS_TOKEN&signature=SIGNATURE&openid=OPENID&sig_method=SIG_METHOD

参数

string access_token

接口调用凭证

string openid

用户唯一标识符

string signature

用户登录态签名

string sig_method

用户登录态签名的哈希方法，目前只支持 hmac_sha256

返回值

Object

返回的 JSON 数据包

属性 类型 说明 支持版本
errcode number 错误码
errmsg string 错误信息

errcode 的合法值

值 说明
0 ok 请求成功
87009 invalid signature 签名错误

调用示例

  1. curl -G 'https://api.weixin.qq.com/wxa/checksession?access_token=OsAoOMw4niuuVbfSxxxxxxxxxxxxxxxxxxx&signature=fefce01bfba4670c85b228e6ca2b493c90971e7c442f54fc448662eb7cd72509&openid=oGZUI0egBJY1zhBYw2KhdUfwVJJE&sig_method=hmac_sha256'

返回示例

正确时的返回JSON数据包如下：

  1. {"errcode": 0, "errmsg": "ok"}

错误时的返回JSON数据包如下（示例为签名错误）：

  1. {"errcode": 87009, "errmsg": "invalid signature"}

原文: https://developers.weixin.qq.com/minigame/dev/api/open-api/login/checkSessionKey.html