大气质量相关

会昌企业帮接口文档V1.0

总述

1.简介


文档介绍.


2.注意

  • 默认年月日时分秒的日期格式,yyyy-MM-dd HH:mm:ss

3.模板


  • 接口地址
  • 功能说明
  • 请求参数
  • 请求示例
  • 响应参数
  • 响应示例

4.统一返回结果集格式

data字段中为实际返回的数据内容

{
    "code": 200,
    "msg": "成功",
    "data": { }
}

5.统一返回结果错误码

状态码 含义
200 成功
500 失败
401 未授权

6.用户授权凭证

用户授权token分为两种,一种是accessToken,用户登录成功后生成,在每次的接口请求中需在head中携带accessToken,另一种为refreshToken,每次请求接口刷新产生新的refreshToken并返回写于head中。

7.分页统一返回数据格式

{
    "success": true,
    "code": 200,
    "message": "成功",
    "data": {
         "total": 1,  
         "size": 10,
         "current": 1,
         "pages": 1
        }
    }
}
参数名 含义
total 总记录数
size 每页记录数(默认10条)
current 当前页码(从1开始)
pages 总页数

会昌企业帮接口

1. 环保—环境质量-空气质量

1.1 获取空气的所有监测站点

API地址

接口地址 请求方式
/api/app/air/getAirAllStation GET

功能说明

  • 获取空气的所有监测站点

请求参数

参数名 含义 是否必填

请求示例

http://localhost:8082/api/app/air/getAirAllStation

响应参数

名称 含义
stationId 站点id
stationName 站点名称
其他字段 暂时无用,请忽略

响应示例

{
    "msg": "操作成功",
    "code": 200,
    "data": [
        {
            "stationId": 1,
            "mn": "77772021080070",
            "stationName": "南北大道中段",
            "longitude": "115.7416",
            "latitude": "25.28044",
            "password": "123456",
            "userId": 0,
            "regionId": 1323,
            "describe": "",
            "status": 1,
            "type": 1,
            "branchId": 11,
            "createDate": "2021-08-17 15:33:30",
            "updateDate": "2021-10-14 10:55:28"
        },
        ...
    ]
}

1.2 获取空气监测指标的数据字典和监测数据

API地址

接口地址 请求方式
/api/app/air/getAirMonitor POST

功能说明

  • 获取空气监测指标的数据字典和监测数据

请求参数

名称 含义 是否必填
pageNo 当前页 Y
pageCount 每页记录数 Y
stationId 站点id Y
openDate 开始时间 Y
endDate 结束时间 Y
type 日期单位:h-小时,d-天(默认h) N

请求示例

http://localhost:8082/api/app/air/getAirMonitor

{
    "pageNo":1,
    "pageCount":10,
    "stationId":3,
    "openDate":"2021-11-23",
    "endDate":"2021-11-24",
    "type":"d"
}

响应参数

factors

名称 含义
factorsCode 字段编号
factorsName 字段名称
factorsUnit 字段单位

data

名称 含义
datatime 监测时间
stationName 站点名称
valMap 属性编号:属性值

响应示例

{
    "msg": "操作成功",
    "code": 200,
    "data": [
        {
            "datatime": "2021-11-24 00:00:00",
            "a21004": "42.90",
            "a21026": "0.00",
            "a21001": "0.000",
            "a21022": "0.30",
            "a99054": "0.200",
            "a01001": "8.70",
            "a21024": "0.100",
            "a01002": "79.80",
            "a01007": "0.00",
            "a01006": "999.70",
            "a01008": "272.30",
            "stationName": "纬二路中段",
            "a34002": "13.50",
            "a34004": "7.70"

        }
        ...
    ],
    "factors": [
        {
            "factorsCode": "a34002",
            "factorsName": "PM10",
            "factorsUnit": "μg/m³"
        },
        ...
    ]
}

1.3 获得所有大气监测站点今日的监测数据

API地址

接口地址 请求方式
/api/app/air/getAirMonitor/today POST

功能说明

  • 获得所有大气监测站点今日的监测数据

请求参数

请求示例

http://localhost:8082/api/app/air/getAirMonitor/today

{
    "pageNo":1,
    "pageCount":10,
    "stationId":3,
    "openDate":"2021-11-23",
    "endDate":"2021-11-24",
    "type":"d"
}

响应参数

factors

名称 含义
factorsCode 字段编号
factorsName 字段名称
factorsUnit 字段单位

data

名称 含义
datatime 监测时间
stationName 站点名称
valMap 属性编号:属性值

响应示例

{
    "msg": "操作成功",
    "code": 200,
    "data": [
        {
            "datatime": "2021-11-30 00:00:00",
            "a21004": "116.00",
            "a21026": "0.10",
            "a21001": "0.000",
            "a21022": "0.10",
            "a99054": "0.100",
            "a01001": "17.90",
            "a21024": "0.000",
            "a01002": "79.70",
            "a01007": "0.50",
            "a01006": "996.10",
            "a01008": "184.30",
            "stationName": "经一路南端",
            "a34002": "14.80",
            "a34004": "6.00"
        },
        ...
    ],
    "factors": [
        {
            "factorsCode": "a34002",
            "factorsName": "PM10",
            "factorsUnit": "μg/m³"
        },
        ...
    ]
}