园区模块
<h1 style="text-align:center;color:#089">会昌企业帮接口文档V1.0</h1>
<h1>总述</h1>
<h2>1.简介</h2>
<hr />
<p>文档介绍.</p>
<hr />
<h2>2.注意</h2>
<ul>
<li>默认年月日时分秒的日期格式,<u>yyyy-MM-dd HH:mm:ss</u></li>
</ul>
<h2>3.模板</h2>
<hr />
<ul>
<li>接口地址</li>
<li>功能说明</li>
<li>请求参数</li>
<li>请求示例</li>
<li>响应参数</li>
<li>响应示例</li>
</ul>
<h2>4.统一返回结果集格式</h2>
<p><strong>data字段中为实际返回的数据内容</strong></p>
<pre><code class="language-json">{
"code": 200,
"msg": "成功",
"data": { }
}</code></pre>
<h2>5.统一返回结果错误码</h2>
<table>
<thead>
<tr>
<th style="text-align: center;">状态码</th>
<th style="text-align: center;">含义</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: center;">200</td>
<td style="text-align: center;">成功</td>
</tr>
<tr>
<td style="text-align: center;">500</td>
<td style="text-align: center;">失败</td>
</tr>
<tr>
<td style="text-align: center;">401</td>
<td style="text-align: center;">未授权</td>
</tr>
</tbody>
</table>
<h2>6.用户授权凭证</h2>
<p>用户授权token分为两种,一种是accessToken,用户登录成功后生成,在每次的接口请求中需在head中携带accessToken,另一种为refreshToken,每次请求接口刷新产生新的refreshToken并返回写于head中。</p>
<h2>7.分页统一返回数据格式</h2>
<pre><code class="language-json">{
"success": true,
"code": 200,
"message": "成功",
"data": {
"total": 1,
"size": 10,
"current": 1,
"pages": 1
}
}
}</code></pre>
<table>
<thead>
<tr>
<th style="text-align: center;">参数名</th>
<th style="text-align: center;">含义</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: center;">total</td>
<td style="text-align: center;">总记录数</td>
</tr>
<tr>
<td style="text-align: center;">size</td>
<td style="text-align: center;">每页记录数(默认10条)</td>
</tr>
<tr>
<td style="text-align: center;">current</td>
<td style="text-align: center;">当前页码(从1开始)</td>
</tr>
<tr>
<td style="text-align: center;">pages</td>
<td style="text-align: center;">总页数</td>
</tr>
</tbody>
</table>
<h1>会昌企业帮接口</h1>
<h1>0.园区模块</h1>
<h2>0.1 获取园区能源消耗数据</h2>
<h3>API地址</h3>
<table>
<thead>
<tr>
<th style="text-align: center;">接口地址</th>
<th style="text-align: center;">请求方式</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: center;">/api/app/parkEnergyConsume/list</td>
<td style="text-align: center;">POST</td>
</tr>
</tbody>
</table>
<h3>功能说明</h3>
<ul>
<li>获取园区当前年份和上一年份能源消耗数据</li>
</ul>
<h3>请求参数</h3>
<table>
<thead>
<tr>
<th style="text-align: center;">参数名</th>
<th style="text-align: center;">含义</th>
<th style="text-align: center;">是否必填</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: center;">year</td>
<td style="text-align: center;">当前年份</td>
<td style="text-align: center;">Y</td>
</tr>
</tbody>
</table>
<p>=</p>
<h3>请求示例</h3>
<pre><code class="language-json">{
"year":2021
}</code></pre>
<h3>响应参数</h3>
<table>
<thead>
<tr>
<th style="text-align: center;">名称</th>
<th style="text-align: center;">含义</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: center;">year</td>
<td style="text-align: center;">年份</td>
</tr>
<tr>
<td style="text-align: center;">list</td>
<td style="text-align: center;">数据</td>
</tr>
</tbody>
</table>
<p>list</p>
<table>
<thead>
<tr>
<th style="text-align: center;">名称</th>
<th style="text-align: center;">含义</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: center;">electricity</td>
<td style="text-align: center;">用电量(万千瓦时)</td>
</tr>
<tr>
<td style="text-align: center;">coal</td>
<td style="text-align: center;">燃煤(吨)</td>
</tr>
<tr>
<td style="text-align: center;">naturalGas</td>
<td style="text-align: center;">天然气(万立方米)</td>
</tr>
</tbody>
</table>
<h3>响应示例</h3>
<pre><code class="language-json">{
"msg": "操作成功",
"code": 200,
"data": [
{
"year": 2020,
"list": [
{
"electricity": 31833.00,
"coal": 88221.00,
"naturalGas": 965.00,
"year": 2020,
"month": 12
},
{
"electricity": 34962.00,
"coal": 86059.00,
"naturalGas": 824.00,
"year": 2020,
"month": 11
},
{
"electricity": 37995.00,
"coal": 89029.00,
"naturalGas": 956.00,
"year": 2020,
"month": 10
},
{
"electricity": 33387.00,
"coal": 88680.00,
"naturalGas": 998.00,
"year": 2020,
"month": 9
},
{
"electricity": 37668.00,
"coal": 88417.00,
"naturalGas": 978.00,
"year": 2020,
"month": 8
},
{
"electricity": 32030.00,
"coal": 88645.00,
"naturalGas": 730.00,
"year": 2020,
"month": 7
},
{
"electricity": 31963.00,
"coal": 84000.00,
"naturalGas": 900.00,
"year": 2020,
"month": 6
},
{
"electricity": 31809.00,
"coal": 86927.00,
"naturalGas": 879.00,
"year": 2020,
"month": 5
},
{
"electricity": 35762.00,
"coal": 80918.00,
"naturalGas": 963.00,
"year": 2020,
"month": 4
},
{
"electricity": 34920.00,
"coal": 86243.00,
"naturalGas": 873.00,
"year": 2020,
"month": 3
},
{
"electricity": 37791.00,
"coal": 84403.00,
"naturalGas": 817.00,
"year": 2020,
"month": 2
},
{
"electricity": 34608.00,
"coal": 97042.00,
"naturalGas": 708.00,
"year": 2020,
"month": 1
}
]
},
{
"year": 2021,
"list": [
{
"electricity": 38021.00,
"coal": 93921.00,
"naturalGas": 832.00,
"year": 2021,
"month": 11
},
{
"electricity": 33792.00,
"coal": 80699.00,
"naturalGas": 720.00,
"year": 2021,
"month": 11
},
{
"electricity": 32184.00,
"coal": 99127.00,
"naturalGas": 823.00,
"year": 2021,
"month": 10
},
{
"electricity": 38201.00,
"coal": 98312.00,
"naturalGas": 893.00,
"year": 2021,
"month": 9
},
{
"electricity": 40123.00,
"coal": 96348.00,
"naturalGas": 810.00,
"year": 2021,
"month": 8
},
{
"electricity": 35892.00,
"coal": 98402.00,
"naturalGas": 883.00,
"year": 2021,
"month": 7
},
{
"electricity": 37998.00,
"coal": 93940.00,
"naturalGas": 801.00,
"year": 2021,
"month": 6
},
{
"electricity": 37393.00,
"coal": 97034.00,
"naturalGas": 805.00,
"year": 2021,
"month": 5
},
{
"electricity": 36678.00,
"coal": 97883.00,
"naturalGas": 828.00,
"year": 2021,
"month": 4
},
{
"electricity": 40023.00,
"coal": 99002.00,
"naturalGas": 800.00,
"year": 2021,
"month": 2
},
{
"electricity": 35996.00,
"coal": 97478.00,
"naturalGas": 822.00,
"year": 2021,
"month": 2
}
]
}
]
}</code></pre>
<h2>0.2 根据年份查询园区年度信息</h2>
<h3>API地址</h3>
<table>
<thead>
<tr>
<th style="text-align: center;">接口地址</th>
<th style="text-align: center;">请求方式</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: center;">/api/app/parkYearInfo/getByYear</td>
<td style="text-align: center;">POST</td>
</tr>
</tbody>
</table>
<h3>功能说明</h3>
<ul>
<li>
<pre><code>根据年份查询园区年度信息</code></pre>
</li>
</ul>
<h3>请求参数</h3>
<table>
<thead>
<tr>
<th style="text-align: center;">参数名</th>
<th style="text-align: center;">含义</th>
<th style="text-align: center;">是否必填</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: center;">parkYear</td>
<td style="text-align: center;">所记录年份</td>
<td style="text-align: center;">Y</td>
</tr>
</tbody>
</table>
<h3>请求示例</h3>
<p><a href="http://localhost:8082/api/app/parkYearInfo/getByYear">http://localhost:8082/api/app/parkYearInfo/getByYear</a></p>
<pre><code class="language-json">{
"parkYear": "2021"
}</code></pre>
<h3>响应参数</h3>
<table>
<thead>
<tr>
<th style="text-align: center;">名称</th>
<th style="text-align: center;">含义</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: center;">parkYear</td>
<td style="text-align: center;">所记录年份</td>
</tr>
<tr>
<td style="text-align: center;">parkValue</td>
<td style="text-align: center;">园区工业产值</td>
</tr>
<tr>
<td style="text-align: center;">parkFsSale</td>
<td style="text-align: center;">氟盐化工销售额</td>
</tr>
<tr>
<td style="text-align: center;">parkFsTax</td>
<td style="text-align: center;">氟盐化工税收</td>
</tr>
<tr>
<td style="text-align: center;">avgParkValue</td>
<td style="text-align: center;">亩产产值</td>
</tr>
<tr>
<td style="text-align: center;">avgParkFsTax</td>
<td style="text-align: center;">亩产税收</td>
</tr>
</tbody>
</table>
<h3>响应示例</h3>
<pre><code class="language-json">{
"msg": "操作成功",
"code": 200,
"parkYearInfo": {
"parkYear": 2021,
"parkValue": 4217000000.00,
"parkFsSale": 4152000000.00,
"parkFsTax": 47000000.00,
"avgParkValue": 1621923.08,
"avgParkFsTax": 18076.92
}
}</code></pre>
<h2>0.3 查询园区企业生产情况实时记录</h2>
<h3>API地址</h3>
<table>
<thead>
<tr>
<th style="text-align: center;">接口地址</th>
<th style="text-align: center;">请求方式</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: center;">/api/app/parkMonitorNew/getMonitor</td>
<td style="text-align: center;">POST</td>
</tr>
</tbody>
</table>
<h3>功能说明</h3>
<ul>
<li>
<pre><code>查询园区企业生产情况实时记录</code></pre>
</li>
</ul>
<h3>请求参数</h3>
<table>
<thead>
<tr>
<th style="text-align: center;">参数名</th>
<th style="text-align: center;">含义</th>
<th style="text-align: center;">是否必填</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: center;">无</td>
<td style="text-align: center;"></td>
<td style="text-align: center;"></td>
</tr>
</tbody>
</table>
<h3>请求示例</h3>
<pre><code class="language-json">http://localhost:8082/api/app/parkMonitorNew/getMonitor</code></pre>
<h3>响应参数</h3>
<table>
<thead>
<tr>
<th style="text-align: center;">名称</th>
<th style="text-align: center;">含义</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: center;">id</td>
<td style="text-align: center;">编号</td>
</tr>
<tr>
<td style="text-align: center;">parkMonitorNum</td>
<td style="text-align: center;">生产监控企业数量</td>
</tr>
<tr>
<td style="text-align: center;">parkProdNum</td>
<td style="text-align: center;">正在生产企业数量</td>
</tr>
<tr>
<td style="text-align: center;">parkGasNum</td>
<td style="text-align: center;">废气监测点位数量</td>
</tr>
<tr>
<td style="text-align: center;">parkSewageNum</td>
<td style="text-align: center;">污水排放口数量</td>
</tr>
<tr>
<td style="text-align: center;">parkHazardNum</td>
<td style="text-align: center;">危废监测点位数量</td>
</tr>
<tr>
<td style="text-align: center;">parkAllPeople</td>
<td style="text-align: center;">园区总人数</td>
</tr>
<tr>
<td style="text-align: center;">parkAllCar</td>
<td style="text-align: center;">园区总车辆</td>
</tr>
<tr>
<td style="text-align: center;">updateTime</td>
<td style="text-align: center;">更新时间</td>
</tr>
</tbody>
</table>
<h3>响应示例</h3>
<pre><code class="language-json">{
"msg": "操作成功",
"code": 200,
"data": {
"id": 1,
"parkMonitorNum": 30,
"parkProdNum": 15,
"parkGasNum": 24,
"parkSewageNum": 20,
"parkHazardNum": 10,
"parkAllPeople": 888,
"parkAllCar": 147,
"updateTime": "2021/12/02 15:45:40"
}
}</code></pre>
<h2>0.4 获取化学式产品价格波动数据详情</h2>
<h3>API地址</h3>
<table>
<thead>
<tr>
<th style="text-align: center;">接口地址</th>
<th style="text-align: center;">请求方式</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: center;">/api/app/chemical/price</td>
<td style="text-align: center;">GET</td>
</tr>
</tbody>
</table>
<h3>功能说明</h3>
<ul>
<li>
<pre><code>获取化学式产品价格波动数据详情
注:本周均价为空,则周涨跌幅必为空;本周均价有值,周涨跌幅可能为空(上周无值更新)</code></pre>
</li>
</ul>
<h3>请求参数</h3>
<p>无</p>
<h3>请求示例</h3>
<pre><code class="language-json">http://localhost:8082/api/app/chemical/price</code></pre>
<h3>响应参数</h3>
<table>
<thead>
<tr>
<th style="text-align: center;">名称</th>
<th style="text-align: center;">含义</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: center;">chemicalCode</td>
<td style="text-align: center;">化学品字典编号</td>
</tr>
<tr>
<td style="text-align: center;">chemicalName</td>
<td style="text-align: center;">化学品名称</td>
</tr>
<tr>
<td style="text-align: center;">price</td>
<td style="text-align: center;">报价(单位:元/吨)</td>
</tr>
<tr>
<td style="text-align: center;">createTime</td>
<td style="text-align: center;">最新发布时间</td>
</tr>
<tr>
<td style="text-align: center;">avgPriceOfweek</td>
<td style="text-align: center;">本周均价</td>
</tr>
<tr>
<td style="text-align: center;">flowOfWeek</td>
<td style="text-align: center;">周涨跌幅</td>
</tr>
</tbody>
</table>
<h3>响应示例</h3>
<pre><code class="language-json">{
"msg": "操作成功",
"code": 200,
"data": [
{
"chemicalCode": "01",
"chemicalName": "萤石",
"price": 3100.0,
"createTime": "2021/11/30 00:00:00",
"avgPriceOfweek": 3025.0,
"flowOfWeek": null
},
{
"chemicalCode": "02",
"chemicalName": "氢氟酸",
"price": 4000.0,
"createTime": "2021/11/30 00:00:00",
"avgPriceOfweek": 3950.0,
"flowOfWeek": null
},
...
]
}</code></pre>
<h2>0.5 获取园区危化品数据统计信息</h2>
<h3>API地址</h3>
<table>
<thead>
<tr>
<th style="text-align: center;">接口地址</th>
<th style="text-align: center;">请求方式</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: center;">/api/app/parkYearInfo/getDangerousProduct</td>
<td style="text-align: center;">GET</td>
</tr>
</tbody>
</table>
<h3>功能说明</h3>
<ul>
<li>
<pre><code>获取园区危化品数据统计信息</code></pre>
</li>
</ul>
<h3>请求参数</h3>
<p>无</p>
<h3>请求示例</h3>
<pre><code class="language-json">http://localhost:8082/api/app/parkYearInfo/getDangerousProduct</code></pre>
<h3>响应参数</h3>
<table>
<thead>
<tr>
<th style="text-align: center;">名称</th>
<th style="text-align: center;">含义</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: center;">poison</td>
<td style="text-align: center;">毒害品</td>
</tr>
<tr>
<td style="text-align: center;">corrosives</td>
<td style="text-align: center;">腐蚀品</td>
</tr>
<tr>
<td style="text-align: center;">oxidant</td>
<td style="text-align: center;">氧化剂</td>
</tr>
<tr>
<td style="text-align: center;">explosives</td>
<td style="text-align: center;">爆炸品</td>
</tr>
<tr>
<td style="text-align: center;">combustibles</td>
<td style="text-align: center;">易燃品</td>
</tr>
<tr>
<td style="text-align: center;">radiation</td>
<td style="text-align: center;">放射品</td>
</tr>
<tr>
<td style="text-align: center;">gas</td>
<td style="text-align: center;">压缩气</td>
</tr>
</tbody>
</table>
<h3>响应示例</h3>
<pre><code class="language-json">{
"msg": "操作成功",
"code": 200,
"data": {
"poison": 0.08,
"corrosives": 0.2,
"oxidant": 0.2,
"explosives": 0.2,
"combustibles": 0.2,
"radiation": 0.02,
"gas": 0.1
}
}</code></pre>