用户信息 /用户信息 /检查加密信息

# 检查加密信息

> 接口应在服务器端调用，详细说明参见[服务端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 内容错误         |

|      |      |      |
| :--- | :--- | :--- |
|      |      |      |
|      |      |      |
|      |      |      |