获取用户encryptKey
获取用户encryptKey
接口应在服务器端调用,详细说明参见服务端API。
接口说明
接口英文名
getUserEncryptKey
功能描述
该接口用于获取用户encryptKey。 会获取用户最近3次的key,每个key的存活时间为3600s。
调用方式
HTTPS 调用
GET https://api.weixin.qq.com/wxa/business/getuserencryptkey?access_token=ACCESS_TOKEN&signature=SIGNATURE&openid=OPENID&sig_method=SIG_METHOD
第三方调用
- 调用方式以及出入参和HTTPS相同,仅是调用的token不同
- 该接口所属的权限集id为:18
- 服务商获得其中之一权限集授权后,可通过使用authorizer_access_token代商家进行调用
请求参数
属性 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | string | 是 | 接口调用凭证,该参数为 URL 参数,非 Body 参数。使用access_token或者authorizer_access_token |
openid | string | 是 | 用户的openid |
signature | string | 是 | 用sessionkey作为密钥对空字符串签名得到的结果。session_key可通过code2Session接口获得。 |
sig_method | string | 是 | 签名方法,只支持 hmac_sha256 |
返回参数
属性 | 类型 | 说明 | |
---|---|---|---|
errcode | number | 错误码 | |
errmsg | string | 错误信息 | |
key_info_list | array | 用户最近三次的加密key列表 | |
属性类型说明encrypt_keystring加密keyversionnumberkey的版本号expire_innumber剩余有效时间ivstring加密ivcreate_timenumber创建key的时间戳 |
调用示例
示例说明: HTTPS调用
请求数据示例
GET https://api.weixin.qq.com/wxa/business/getuserencryptkey?access_token=OsAoOMw4niuuVbfSxxxxxxxxxxxxxxxxxxx&signature=fefce01bfba4670c85b228e6ca2b493c90971e7c442f54fc448662eb7cd72509&openid=oGZUI0egBJY1zhBYw2KhdUfwVJJE&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
}
]
}
错误码
错误码 | 错误描述 | 解决方案 |
---|---|---|
40001 | invalid credential access_token isinvalid or not latest | 获取 access_token 时 AppSecret 错误,或者 access_token 无效。请开发者认真比对 AppSecret 的正确性,或查看是否正在为恰当的公众号调用接口 |
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】凌霞软件回馈社区,博客园 & 1Panel & Halo 联合会员上线
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】博客园社区专享云产品让利特惠,阿里云新客6.5折上折
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步
· 一个费力不讨好的项目,让我损失了近一半的绩效!
· 实操Deepseek接入个人知识库
· CSnakes vs Python.NET:高效嵌入与灵活互通的跨语言方案对比
· 【.NET】调用本地 Deepseek 模型
· Plotly.NET 一个为 .NET 打造的强大开源交互式图表库