用户信息 /用户信息 /检查加密信息 # 检查加密信息 > 接口应在服务器端调用,详细说明参见[服务端API](https://developers.weixin.qq.com/miniprogram/dev/framework/server-ability/backend-api.html)。 ## 接口说明 ### 接口英文名 checkEncryptedData ### 功能描述 检查加密信息是否由微信生成(当前只支持手机号加密数据),只能检测最近3天生成的加密数据。 ## 调用方式 ### HTTPS 调用 ```text POST https://api.weixin.qq.com/wxa/business/checkencryptedmsg?access_token=ACCESS_TOKEN ``` ### 第三方调用 - 调用方式以及出入参和 HTTPS 相同,仅是调用的 token 不同 - 该接口所属的权限集 id 为:18 - 服务商获得其中之一权限集授权后,可通过使用[authorizer_access_token](https://developers.weixin.qq.com/doc/oplatform/Third-party_Platforms/2.0/api/ThirdParty/token/api_authorizer_token.html)代商家进行调用 ### 请求参数 | 属性 | 类型 | 必填 | 说明 | | :------------------------------------ | :----- | :--- | :----------------------------------------------------------- | | access_token / cloudbase_access_token | string | 是 | 接口调用凭证,该参数为 URL 参数,非 Body 参数。access_token和cloudbase_access_token二选一 其中access_token可通过[getAccessToken](https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/access-token/auth.getAccessToken.html)接口获得; 如果是第三方代调用请传入[authorizer_access_token](https://developers.weixin.qq.com/doc/oplatform/Third-party_Platforms/2.0/api/ThirdParty/token/api_authorizer_token.html); cloudbase_access_token可通过[getOpenData](https://developers.weixin.qq.com/miniprogram/dev/wxcloudrun/src/guide/weixin/token.html)接口获得 | | encrypted_msg_hash | string | 是 | 加密数据的sha256,通过Hex(Base16)编码后的字符串 | ### 返回参数 | 属性 | 类型 | 说明 | | :---------- | :------ | :------------------- | | errcode | number | 错误码 | | errmsg | string | 错误提示信息 | | vaild | boolean | 是否是合法的数据 | | create_time | number | 加密数据生成的时间戳 | ## 调用示例 > 示例说明: HTTPS调用示例 ### 请求数据示例 ```json { "encrypted_msg_hash": "657edd868c9715a9bebe42b833269a557a48498785397a796f1568c29a200b2c" } ``` ### 返回数据示例 ```json { "errcode": 0, "errmsg": "ok", "vaild": true, "create_time" :1629121902 } ``` ### 错误码 | 错误码 | 错误码取值 | 解决方案 | | :----- | :---------------- | :----------------------------- | | -1 | system error | 系统繁忙,此时请开发者稍候再试 | | 40097 | invalid args | 参数错误 | | 44002 | empty post data | POST 的数据包为空 | | 47001 | data format error | 解析 JSON/XML 内容错误 | | | | | | :--- | :--- | :--- | | | | | | | | | | | | |