长鹏定制防伪开放接口

#  长鹏定制防伪开放接口 `公开`

## 支持场景
>  已支持：防伪查询；物流码查防伪；超次；超期；支持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                                                  |
|----------|--------------------------------------------------------|
| 请求方法 | POST                                                   |
| 请求路径 | /pms/project/open-anti/cp-anti                  |

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

###  传入参数

| 参数名称                                                                                                                                                                                                                                                                                                                                                                                                     | 是否必填 | 参数类型 | 参数说明                                                                |
|-----------|----------|----------|------------------|
| channelType                                                                                                                                                                                                                                                                                                                                                                                                  | 是       | String   | 渠道类型  W:网站， X：微信，  M:H5 wap，  T:电话， V:微信小程序， P:App |
| file                                                                                                                                                                                                                                                                                                                                                                                                         | 是       | MultipartFile   | 查询数码图片文件流，要求jpg、png                                                  |
| 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                                                   |
| openId                                                                                                                                                                                                                                                                                                                                                                                                   | 是       | String   | 用户openId                                                   |

### 传出参数

| 参数名称  | 参数类型     | 参数说明                 |
|-----------|--------------|--------------------------|
| 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/pms/project/open-anti/cp-anti

form-data表单提交方式请求

```

### 出参示例

```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               | 成功                              |
| 21130011 | 查询数码不能为空  |
| 21130012  | 渠道类型不能为空 |
| 21130003          | 渠道类型不正确                    |
| 21130004          | 请求id不能为空                    |
| 21130008          | 语言类型不能为空                  |
| 21130010          | 目标通道不能为空                  |
| 21130002          | 网络出现异常，请稍后重试          |
| 21131100          | 文件类型不支持，只允许上传 jpg 或 png 文件          |
| 21131101          | 图片中二维码受影响无法解析二维码，可能文件过大，建议200KB左右         |
| 21131102          | 文件中二维码解析异常          |
| 21131103          | 二维码解析数码异常          |
| 21131104          | 数码解码异常          |
| 21131105          | 文件中二维码解析版本不一致          |
| 21131106          | openId不能为空          |
| 21131107          | 企业号信息不正确          |

### 答复类型（replyType）说明
| 答复类型 | 说明                                                                           |
|----------|--------------------------------------------------------------------------------|
| 200205   | 数码不存在                                                                     |
| 200206   | 固定错误答复，偶发解码失败、异常。 |
| 200207   | 解码无法识别 |
| 300102   | 数码未激活                                                                     |
| 300103   | 数码超期                                                                       |
| 300104   | 首查                                                                           |
| 300105   | 复查                                                                           |
| 300106   | 数码超次                                                                       |
| 300107   | 物流码不能查防伪     |