防伪区域查询

#  防伪区域查询 `公开`

## 支持场景
>  已支持：防伪区域查询

## API描述
>  API描述：防伪区域查询
超8平台提供第三方对接标准数据功能，该文档详细描述第三方系统对接超8防伪领域服务的相关规范。
本文档主要面向企业开发（包括产品、研发和测试）。

## 请求流程

>   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                                                   |
| 请求路径 | /base/app/v1/open/anti/anti-report-form/query-anti-region-report|

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

###  传入参数

| 参数名称                                                                                                                                                                                                                                                                                                                                                                                                     | 是否必填 | 参数类型 | 参数说明                                                                |
|-----------|----------|----------|------------------|
| startDate      | 是       | String   | 开始日期|
| endDate      | 是       | String   | 结束日期|
| productId      | 否       | String   | 产品id模糊搜索|
| pro      | 否       | String   | 省份|
| areaCode      | 否       | String   | 地区编码 - 国、省、市、区|
| labelNo      | 否       | String   | 标签编号|
| useInDateTime      | 否       | String   | 转换时区功能使用，传1，默认不传|
| useUserZone      | 否       | String   | 导出，是否根据用户转时区，1转，2不转 默认不转|
| areaType      | 否       | String   | 防伪区域时区，区域类别，1世界，2国家，3省份|
| country      | 否       | String   | 国家|
| productIds      | 否       | String   | 商品ID列表|

### 传出参数

| 参数名称  | 参数类型     | 参数说明                 |
|-----------|--------------|--------------------------|
| code      | String       | 状态：200 成功           |
| message   | String       | 信息                     |
| timestamp | Long         | 时间戳                   |
| traceId   | String       | 追踪id                   |
| data      | List（Data） | Data如下描述 |

Data返回对象说明

| 参数名称        | 参数类型 | 参数说明                                                      |
|-----------------|----------|---------------------------------------------------|
| city       | String   | 城市|
| pro       | String   | 省份|
| total       | int   | 区域查询数量|

### 请求示例
```json

https://open-fat.yesno.com.cn/base/app/v1/open/anti/anti-report-form/get-page-list?code=123456
```

### 出参示例

```json
{
    "code": 200,
    "message": "success",
    "data": [
        {
            "city": "合肥",
            "pro": "安徽",
            "total": 1
        }
    ],
    "timestamp": 1716194098185,
    "traceId": "",
    "exception": null,
    "meta": null,
    "ext": null
}
```

### Code错误码说明
| 错误代码          | 描述                              |
|-------------------|-----------------------------------|
| 200               | 成功                              |
| 21132002 | startDate不能为空  |
| 21132003 | endDate不能为空  |