# 检查加密信息
接口应在服务器端调用,详细说明参见服务端API。
# 接口说明
# 接口英文名
checkEncryptedData
# 功能描述
检查加密信息是否由微信生成(当前只支持手机号加密数据),只能检测最近3天生成的加密数据。
# 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/wxa/business/checkencryptedmsg?access_token=ACCESS_TOKEN
# 第三方调用
调用方式以及出入参和HTTPS相同,仅是调用的token不同
该接口所属的权限集id为:18
服务商获得其中之一权限集授权后,可通过使用authorizer_access_token代商家进行调用
# 请求参数
属性 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | string | 是 | 接口调用凭证,该参数为 URL 参数,非 Body 参数。使用access_token或者authorizer_access_token |
encrypted_msg_hash | string | 是 | 加密数据的sha256,通过Hex(Base16)编码后的字符串 |
# 返回参数
属性 | 类型 | 说明 |
---|---|---|
errcode | number | 错误码 |
errmsg | string | 错误提示信息 |
vaild | boolean | 是否是合法的数据 |
create_time | number | 加密数据生成的时间戳 |
# 调用示例
示例说明: HTTPS调用示例
# 请求数据示例
{
"encrypted_msg_hash": "657edd868c9715a9bebe42b833269a557a48498785397a796f1568c29a200b2c"
}
# 返回数据示例
{
"errcode": 0,
"errmsg": "ok",
"vaild": true,
"create_time" :1629121902
}
# 错误码
错误码 | 错误码取值 | 解决方案 |
---|---|---|
-1 | system error | 系统繁忙,此时请开发者稍候再试 |
1 | data not exit | 加密数据不存在,数据生成的时间超过保存的限制(3天)或者 key 不存在,或者数据和appid不匹配 |
40097 | invalid args | 参数错误 |
44002 | empty post data | POST 的数据包为空。post请求body参数不能为空。 |
47001 | data format error | 解析 JSON/XML 内容错误;post 数据中参数缺失;检查修正后重试。 |