防伪码开放接口-支持验证码校验

#  防伪开放接口 `公开`

## 支持场景
>  已支持：防伪查询；物流码查防伪；超次；超期；支持GPS解析，IP解析;验证码校验

## API描述
>  API描述：根据数码查询数码的真伪，状态
超8平台提供第三方对接标准数据功能，该文档详细描述第三方系统对接超8防伪领域服务的相关规范。
本文档主要面向企业开发（包括产品、研发和测试）。
> 查询数码防伪相关信息，包括数码状态、查询次数、首查时间、答复内容等。首查时更新d表查询次数、查询时间，复查时只更新查询次数，不更新查询时间，其他答复类型不更新d表信息。

## 请求流程

>   1. 在超8平台中申请第三方系统的应用Access Key和密钥（线下）。
>   2. 第三方系统根据应用Access Key和密钥向系统发起**Access Token**申请【 [如何获取token](https://developers.yesno.com.cn/doc/57/ "如何获取token")】。
>   3. 三方系统调用防伪领域服务的开放接口进行数据对接。

> 具体请求请参阅：
>请参阅  [请求流程](https://developers.yesno.com.cn/doc/56/ "请求流程")

## 请求信息

| 协议     | HTTPS                                                  |
|----------|--------------------------------------------------------|
| 请求方法 | GET                                                   |
| 请求路径 | /ps/v1/open/anti/antiQuery/verifyCheckCode                  |
| 请求体   |https://open-fat.yesno.com.cn/ps/v1/open/anti/antiQuery/verifyCheckCode?checkCode=384971&channelType=W&code=7152500280752848&requestId=5ab9595e4da98c38f4f771a4ab676138&languageType=zh-CN&fromInfo=19955198617&toInfo=072513891161169172&webBrowser=Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:101.0) Gecko/20100101 Firefox/101.0 |

##  header头
请参阅 [通用请求头](https://developers.yesno.com.cn/doc/56/ "请求头")

###  传入参数

| 参数名称                                                                                                                                                                                                                                                                                                                                                                                                     | 是否必填 | 参数类型 | 参数说明                                                                |
|-----------|----------|----------|------------------|
| checkCode                                                                                                                                                                                                                                                                                                                                                                                                   | 是       | String   | 生码时生成防伪码对应的固定长度验证码                                                   |
| channelType                                                                                                                                                                                                                                                                                                                                                                                                  | 是       | String   | 渠道类型  W:网站， X：微信，  M:H5 wap，  T:电话， V:微信小程序， P:App |
| code                                                                                                                                                                                                                                                                                                                                                                                                         | 是       | String   | 查询数码，支持url链接                                                   |
| decodeVer                                                                                                                                                                                                                                                                                                                                                                                                    | 否       | String   | 解码版本号                                                              |
| enterpriseNo                                                                                                                                                                                                                                                                                                                                                                                                 | 否       | String   | 企业号                                                                  |
| fromInfo                                                                                                                                                                                                                                                                                                                                                                                                     | 否       | String   | 客户端来源 经纬度【纬度,经度】/ip地址/号码                              |
| languageType                                                                                                                                                                                                                                                                                                                                                                                                 | 是       | String   | 语言类型,如 中文zh-CN 英文en-US                                         |
| requestId                                                                                                                                                                                                                                                                                                                                                                                                    | 是       | String   | 请求id 32位guid，用作接口幂等，每次请求不一样                           |
| toInfo                                                                                                                                                                                                                                                                                                                                                                                                       | 是       | String   | 目标通道，h5域名/数码                                                   |
| webBrowser                                                                                                                                                                                                                                                                                                                                                                                                   | 否       | String   | 客户端信息，userAgent                                                   |
| f1                                                                                                                                                                                                                                                                                                                                                                                                   | 否       | String   | f1                                                   |
| f2                                                                                                                                                                                                                                                                                                                                                                                                   | 否       | String   | f2                                                   |
| f3                                                                                                                                                                                                                                                                                                                                                                                                   | 否       | String   | f3                                                   |
| f4                                                                                                                                                                                                                                                                                                                                                                                                   | 否       | String   | f4                                                   |
| f5                                                                                                                                                                                                                                                                                                                                                                                                   | 否       | String   | f5                                                   |
| f6                                                                                                                                                                                                                                                                                                                                                                                                   | 否       | String   | f6                                                   |
| f7                                                                                                                                                                                                                                                                                                                                                                                                   | 否       | String   | f7                                                   |
| f8                                                                                                                                                                                                                                                                                                                                                                                                   | 否       | String   | f8                                                   |
| f9                                                                                                                                                                                                                                                                                                                                                                                                   | 否       | String   | f9                                                   |
| f10                                                                                                                                                                                                                                                                                                                                                                                                   | 否       | String   | f10                                                   |

### 传出参数

| 参数名称  | 参数类型     | 参数说明                 |
|-----------|--------------|--------------------------|
| code      | String       | 状态：200 成功           |
| message   | String       | 信息                     |
| timestamp | Long         | 时间戳                   |
| traceId   | String       | 追踪id                   |
| data      | String(Json) | JsonObject格式，如下描述 |

Data返回对象说明

| 参数名称        | 参数类型 | 参数说明                                                      |
|-----------------|----------|---------------------------------------------------------------|
| replyId         | String   | 答复id                                                        |
| replyType       | String   | 答复类型                                                      |
| num             | String   | 查询次数                                                      |
| date            | String   | 查询时间                                                      |
| content         | String   | 答复内容                                                      |
| skuLogisticCode | String   | 单品物流码                                                    |
| result          | Bool     | 查询状态，首查、复查为true，其他为false                       |
| logicColor      | String   | 防伪码对应的鉴码辨彩，如：6:8:8:6:2:8:2:8:6:6:8:3:3:3:2:6     |
| queryCode       | String   | 当前查询的数码(1：URL解码后的防伪码；2输入的防伪码：直接返回) |
| productId       | String   | 商品id |

### 请求示例
```json

https://open-fat.yesno.com.cn/ps/v1/open/anti/antiQuery/verifyCheckCode?channelType=W&code=7152500280752848&requestId=5ab9595e4da98c38f4f771a4ab676138&languageType=zh-CN&fromInfo=19955198617&toInfo=072513891161169172&webBrowser=Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:101.0) Gecko/20100101 Firefox/101.0
```

### 出参示例

```json
{
"code": 200,
"message": "success",
"data": {
"replyId": "000000000000_G_300104",
"replyType": "300104",
"num": "1",
"date": "2022-11-24 14:14:24",
"content": "该商品是正品，感谢使用！",
"result": true,
"skuLogisticCode": "130801000002",
"logicColor": null
 },
"timestamp": 1669270464374,
"traceId": "43f0121ed14a4ee6a8c3f7749515f9bf.139.16692704642143123"
}
```

### Code错误码说明
| 错误代码          | 描述                              |
|-------------------|-----------------------------------|
| 200               | 成功                              |
| 239102015 | 验证码校验失败  |
| 239102016 | 验证码不能为空  |
| 21100004 | 数码不能为空  |
21130012  | 渠道类型不能为空 |
| 21130003          | 渠道类型不正确                    |
| 21130004          | 请求id不能为空                    |
| 21130008          | 语言类型不能为空                  |
| 21130010          | 目标通道不能为空                  |
| 21130002          | 网络出现异常，请稍后重试          |

### 答复类型（replyType）说明
| 答复类型 | 说明                                                                           |
|----------|--------------------------------------------------------------------------------|
| 200205   | 数码不存在                                                                     |
| 200206   | 固定错误答复，解码失败/解码获得的企业号与传递进来的企业号不一致/防伪查询失败。 |
| 300102   | 数码未激活                                                                     |
| 300103   | 数码超期                                                                       |
| 300104   | 首查                                                                           |
| 300105   | 复查                                                                           |
| 300106   | 数码超次                                                                       |
| 300107   | 物流码不能查防伪                                                               |