# internet.getUserEncryptKey

本接口应在服务器端调用，详细说明参见服务端 API。

获取用户 encryptKey。会获取用户最近 3 次的 key，每个 key 的存活时间为 3600s。

# 请求地址

POST https://api.weixin.qq.com/wxa/business/getuserencryptkey?access_token=ACCESS_TOKEN&openid=OPENID&signature=SIGNATURE&sig_method=hmac_sha256

# 请求参数 - Query

属性	类型	必填	说明
access_token / cloudbase_access_token	string	是	接口调用凭证
openid	string	是	用户的 openid
signature	string	是	用sessionkey对空字符串签名得到的结果。即 signature = hmac_sha256(session_key, "")
sig_method	string	是	签名方法，只支持 hmac_sha256

# 返回值

# Object

返回的 JSON 数据包

属性	类型	说明
errcode	number	错误码
errmsg	string	错误提示信息
key_info_list	Array.<Object>	用户最近三次的加密 key 列表

errcode 的合法值

值	说明	最低版本
0	请求成功
-1	系统繁忙，此时请开发者稍候再试

key_info_list 的结构

属性	类型	说明
encrypt_key	string	加密 key
iv	string	加密 iv
version	number	key 的版本号
expire_in	number	剩余有效时间
create_time	number	创建 key 的时间戳

# 调用示例

curl -X POST "https://api.weixin.qq.com/wxa/business/getuserencryptkey?access_token=ACCESS_TOKEN&openid=OPENID&signature=SIGNATURE&sig_method=hmac_sha256"

# 返回结果示例

{
  "errcode": 0,
  "errmsg": "ok",
  "key_info_list": [
    {
      "encrypt_key": "VI6BpyrK9XH4i4AIGe86tg==",
      "version": 10,
      "expire_in": 3597,
      "iv": "6003f73ec441c386",
      "create_time": 1616572301
    },
    {
      "encrypt_key": "aoUGAHltcliiL9f23oTKHA==",
      "version": 9,
      "expire_in": 0,
      "iv": "7996656384218dbb",
      "create_time": 1616504886
    },
    {
      "encrypt_key": "MlZNQNnRQz3zXHHcr6A3mA==",
      "version": 8,
      "expire_in": 0,
      "iv": "58a1814f88883024",
      "create_time": 1616488061
    }
  ]
}