# 檢驗(yàn)登錄態(tài)

接口應(yīng)在服務(wù)器端調(diào)用，詳細(xì)說(shuō)明參見(jiàn)服務(wù)端API。

# 接口說(shuō)明

# 接口英文名

checkSessionKey

# 功能描述

校驗(yàn)服務(wù)器所保存的登錄態(tài) session_key 是否有效。為了保持 session_key 私密性，接口不明文傳輸 session_key，而是通過(guò)校驗(yàn)登錄態(tài)簽名完成。

session_key 具有唯一性，在使用小程序時(shí)，同一用戶在同一時(shí)刻僅有一個(gè)有效的 session_key。 通過(guò) code2Session 接口獲得的用戶 session_key 擁有一定的時(shí)效性。 除了過(guò)期失效外，觸發(fā)獲取臨時(shí)登錄憑證 code 的操作（小程序登錄 和 數(shù)據(jù)預(yù)拉取）也可能會(huì)生成新的登錄態(tài) session_key，從而使舊的 session_key 被頂替而失效。

為了處理以上失效情況，可以通過(guò)本接口校驗(yàn)用戶 session_key 的有效性。

# 調(diào)用方式

# HTTPS 調(diào)用

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

# 第三方調(diào)用

• 調(diào)用方式以及出入?yún)⒑虷TTPS相同，僅是調(diào)用的token不同

• 該接口所屬的權(quán)限集id為：18

• 服務(wù)商獲得其中之一權(quán)限集授權(quán)后，可通過(guò)使用authorizer_access_token代商家進(jìn)行調(diào)用

# 請(qǐng)求參數(shù)

# 返回值

返回的 JSON 數(shù)據(jù)包

# 調(diào)用示例

示例說(shuō)明: checkSessionKey請(qǐng)求示例

# 請(qǐng)求數(shù)據(jù)示例

GET https://api.weixin.qq.com/wxa/checksession?access_token=OsAoOMw4niuuVbfSxxxxxxxxxxxxxxxxxxx&signature=fefce01bfba4670c85b228e6ca2b493c90971e7c442f54fc448662eb7cd72509&openid=oGZUI0egBJY1zhBYw2KhdUfwVJJE&sig_method=hmac_sha256 

# 返回?cái)?shù)據(jù)示例

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

# 錯(cuò)誤碼