From 299918864d460132dfcb210007dfb9564be15f04 Mon Sep 17 00:00:00 2001 From: xuefei <564615061@qq.com> Date: 星期五, 11 十二月 2020 09:38:35 +0800 Subject: [PATCH] 补贴页面相关接口 --- api.md | 239 ++++++++++++++++++++++++++++++++++++++++++++--------------- 1 files changed, 177 insertions(+), 62 deletions(-) diff --git a/api.md b/api.md index 52079a9..4e2a9f7 100644 --- a/api.md +++ b/api.md @@ -2,15 +2,23 @@ [1.閫氱敤](#1) [ 1.1鑾峰彇鎵�鏈夊尯鍩熸帴鍙(#1.1) + [ 1.2鑾峰彇鍏ㄩ儴琛ヨ创绫诲瀷](#1.2) [2.棣栭〉](#2) - [ 2.1鑾峰彇鍖哄煙娲ヨ创缁熻](#2.1) - -[3.琛ヨ创](#3) - + [ 2.1鑾峰彇鍖哄煙娲ヨ创缁熻](#2.1) + [ 2.2鑾峰彇鍏ㄩ儴琛ヨ创绫诲瀷](#1.2) +[3.琛ヨ创](#3) + [ 3.1鑾峰彇鎬荤粺璁℃暟鎹甝(#3.1) + [ 3.2骞村害鏈堝害缁熻鏁版嵁](#3.2) [4.鏈嶅姟瀵硅薄](#4) -[5.鏈嶅姟鏈烘瀯](#5) +[5.鏈嶅姟鏈烘瀯](#5) + [ 5.1鏍规嵁鍖哄煙id鑾峰彇鍖哄煙涓嬫墍鏈夋満鏋勫拰浜哄憳鏁伴噺浠ュ強璁㈠崟鎬绘暟](#5.1) + [ 5.2鏍规嵁鍖哄煙id鑾峰彇鍖哄煙涓嬫墍鏈夋湇鍔′互鍙婃湇鍔¤鎯呭拰璁㈠崟浜烘暟](#5.2) + [ 5.3鏍规嵁鍖哄煙id鍜岃鍗曢噺鏌ヨ鏈嶅姟鏈烘瀯鎺掑悕鎯呭喌](#5.3) + [ 5.4鏍规嵁鍖哄煙id鍜岃鍗曢噺鏌ヨ鏈嶅姟鏈烘瀯鎺掑悕鎯呭喌](#5.4) + [ 5.5鎵ц涓鍗昡(#5.4) + <h3 id='1'>涓�銆侀�氱敤</h2> <h4 id='1.1'>1.1鑾峰彇鎵�鏈夊尯鍩熸帴鍙�</h4> @@ -18,7 +26,7 @@ > 鑾峰彇鎵�鏈夊尯鍩� ###### URL -> /api/fwjg/getByPage +> /api/common/getAllArea ###### 鏀寔鏍煎紡 > JSON @@ -29,23 +37,119 @@ ###### 璇锋眰鍙傛暟 |鍙傛暟|蹇呴�墊绫诲瀷|璇存槑| |:----- |:-------|:-----|----- | -| pageNumber | 鏄� |int| 鍒嗛〉椤垫暟 | -| pageSize | 鏄� |int| 鍒嗛〉澶у皬 | -| sort | 鍚� |String| 鎺掑簭瀛楁 | -| order | 鍚� |String| 鎺掑簭鏂瑰紡 asc/desc | +###### 杩斿洖瀛楁 +|杩斿洖瀛楁|瀛楁绫诲瀷|璇存槑 | +|:----- |:------|:----------------------------- | +| name | String | 鍚嶇О | +| pid | String | 涓婄骇id | + +###### 杩斿洖绀轰緥 +``` java +{ + "success": true, + "message": "success", + "code": 200, + "timestamp": 1607648233416, + "result": [ + { + "id": "1336922902628536320", + "createBy": null, + "createTime": "2020-12-10 14:37:13", + "updateBy": null, + "updateTime": null, + "delFlag": 0, + "name": "鐭冲搴勫競", + "pid": null + }, + { + "id": "1336923258360041472", + "createBy": null, + "createTime": "2020-12-10 14:38:38", + "updateBy": null, + "updateTime": null, + "delFlag": 0, + "name": "闀垮畨鍖�", + "pid": "1336922902628536320" + }, + ... + ] +} +``` +<h4 id='1.2'>1.2鑾峰彇鍏ㄩ儴琛ヨ创绫诲瀷</h4> +###### 鎺ュ彛鍔熻兘 +> 鑾峰彇鍏ㄩ儴琛ヨ创绫诲瀷 + +###### URL +> /api/common/getAllSubsidyType + +###### 鏀寔鏍煎紡 +> JSON + +###### HTTP璇锋眰鏂瑰紡 +> GET + +###### 璇锋眰鍙傛暟 +|鍙傛暟|蹇呴�墊绫诲瀷|璇存槑| +|:----- |:-------|:-----|----- | +###### 杩斿洖瀛楁 +|杩斿洖瀛楁|瀛楁绫诲瀷|璇存槑 | +|:----- |:------|:----------------------------- | +| index | int | type鍊� | +| name | String | 鍚嶇О | + +###### 杩斿洖绀轰緥 +``` java +{ + "success": true, + "message": "success", + "code": 200, + "timestamp": 1607648519602, + "result": [ + { + "index": 0, + "name": "鍥伴毦娈嬬柧鐢熸椿琛ヨ创" + }, + { + "index": 1, + "name": "閲嶅害娈嬬柧浜虹敓娲昏ˉ璐�" + }, + { + "index": 2, + "name": "楂橀緞鑰佷汉鐢熸椿琛ヨ创" + }, + { + "index": 3, + "name": "楂橀緞鑰佷汉鐢熸椿娲ヨ创" + }, + ... + ] +} +``` +<h3 id='3'>涓夈�佽ˉ璐�</h2> +<h4 id='3.1'>3.1鑾峰彇鎬荤粺璁℃暟鎹�</h4> +###### 鎺ュ彛鍔熻兘 +> 鏍规嵁鍖哄煙id鍜岃ˉ璐寸被鍨嬭幏鍙栨�荤殑缁熻鏁版嵁 + +###### URL +> /api/subsidy/getTotalStatistics + +###### 鏀寔鏍煎紡 +> JSON + +###### HTTP璇锋眰鏂瑰紡 +> GET + +###### 璇锋眰鍙傛暟 +|鍙傛暟|蹇呴�墊绫诲瀷|璇存槑| +|:----- |:-------|:-----|----- | +| areaId | 鍚� |String | 鍖哄煙id | +| type | 鍚� |Integer | 琛ヨ创绫诲瀷 | ###### 杩斿洖瀛楁 |杩斿洖瀛楁|瀛楁绫诲瀷|璇存槑 | |:----- |:------|:----------------------------- | -| total | int | 杩斿洖鍒嗛〉缁撴灉鏁� | -| size | int | 鍒嗛〉澶у皬 | -| current | int | 褰撳墠椤垫暟 | -| pages | int | 鎬诲叡椤垫暟 | -| success | boolean | 鏄惁鎴愬姛 | -| code | int | 杩斿洖code鐮� | -| result | object | 杩斿洖缁撴灉 | -| name | String | 鍚嶇О | -| pid | String | 涓婄骇id | +| totalPersonNum | int | 鑾峰彇琛ヨ创鐨勬�讳汉鏁� | +| fwPersonCount | double | 鎬婚噾棰� | ###### 鎺ュ彛绀轰緥 ``` java @@ -53,53 +157,64 @@ "success": true, "message": "success", "code": 200, - "timestamp": 1607582573231, + "timestamp": 1607648976798, "result": { - "records": [ + "totalPersonNum": 1, + "totalMoney": 100 + } +} +``` +<h4 id='3.2'>3.2骞村害鏈堝害缁熻鏁版嵁</h4> +###### 鎺ュ彛鍔熻兘 +> 鏍规嵁鍖哄煙id鍜岃ˉ璐寸被鍨嬭幏鍙栧勾搴︽湀搴︾粺璁℃暟鎹� + +###### URL +> /api/subsidy/getStatistics + +###### 鏀寔鏍煎紡 +> JSON + +###### HTTP璇锋眰鏂瑰紡 +> GET + +###### 璇锋眰鍙傛暟 +|鍙傛暟|蹇呴�墊绫诲瀷|璇存槑| +|:----- |:-------|:-----|----- | +| areaId | 鍚� |String | 鍖哄煙id | +| type | 鍚� |Integer | 琛ヨ创绫诲瀷 | + +###### 杩斿洖瀛楁 +|杩斿洖瀛楁|瀛楁绫诲瀷|璇存槑 | +|:----- |:------|:----------------------------- | +| monthStatistics | Objec | 鏈堝害缁熻鏁版嵁 | +| yearStatistics | Objec | 骞村害缁熻鏁版嵁 | + +###### 鎺ュ彛绀轰緥 +``` java +{ + "success": true, + "message": "success", + "code": 200, + "timestamp": 1607649436415, + "result": { + "monthStatistics": [ { - "id": "1336922902628536320", - "createBy": null, - "createTime": "2020-12-10 14:37:13", - "updateBy": null, - "updateTime": null, - "delFlag": 0, - "name": "鐭冲搴勫競", - "pid": null - }, - { - "id": "1336923402568601600", - "createBy": null, - "createTime": "2020-12-10 14:39:12", - "updateBy": null, - "updateTime": null, - "delFlag": 0, - "name": "鏂板崕鍖�", - "pid": "1336922902628536320" - }, - { - "id": "1336923441189752832", - "createBy": null, - "createTime": "2020-12-10 14:39:21", - "updateBy": null, - "updateTime": null, - "delFlag": 0, - "name": "姝e畾鍘�", - "pid": "1336922902628536320" + "sum": 100, + "time": "2020-12" } ], - "total": 7, - "size": 10, - "current": 1, - "orders": [], - "hitCount": false, - "searchCount": true, - "pages": 1 + "yearStatistics": [ + { + "sum": 100, + "time": "2020" + } + ] } } ``` -<h3 id='2'>浜屻�佹湇鍔℃満鏋�</h2> -<h4 id='2.1'>2.1鏍规嵁鍖哄煙id鑾峰彇鍖哄煙涓嬫墍鏈夋満鏋勫拰浜哄憳鏁伴噺浠ュ強璁㈠崟鎬绘暟</h4> +<h3 id='5'>浜斻�佹湇鍔℃満鏋�</h2> +<h4 id='5.1'>5.1鏍规嵁鍖哄煙id鑾峰彇鍖哄煙涓嬫墍鏈夋満鏋勫拰浜哄憳鏁伴噺浠ュ強璁㈠崟鎬绘暟</h4> ###### 鎺ュ彛鍔熻兘 > 鏍规嵁鍖哄煙id鑾峰彇鍖哄煙涓嬫墍鏈夋満鏋勫拰浜哄憳鏁伴噺浠ュ強璁㈠崟鎬绘暟 @@ -140,7 +255,7 @@ } } ``` -<h4 id='2.1'>2.1鏍规嵁鍖哄煙id鑾峰彇鍖哄煙涓嬫墍鏈夋湇鍔′互鍙婃湇鍔¤鎯呭拰璁㈠崟浜烘暟</h4> +<h4 id='5.2'>5.2鏍规嵁鍖哄煙id鑾峰彇鍖哄煙涓嬫墍鏈夋湇鍔′互鍙婃湇鍔¤鎯呭拰璁㈠崟浜烘暟</h4> ###### 鎺ュ彛鍔熻兘 > 鏍规嵁鍖哄煙id鑾峰彇鍖哄煙涓嬫墍鏈夋満鏋勫拰浜哄憳鏁伴噺浠ュ強璁㈠崟鎬绘暟 @@ -248,7 +363,7 @@ } } ``` -<h4 id='2.1'>2.3鏍规嵁鍖哄煙id鍜岃鍗曢噺鏌ヨ鏈嶅姟鏈烘瀯鎺掑悕鎯呭喌</h4> +<h4 id='5.3'>5.3鏍规嵁鍖哄煙id鍜岃鍗曢噺鏌ヨ鏈嶅姟鏈烘瀯鎺掑悕鎯呭喌</h4> ###### 鎺ュ彛鍔熻兘 > 鏍规嵁鍖哄煙id鍜岃鍗曢噺鏌ヨ鏈嶅姟鏈烘瀯鎺掑悕鎯呭喌 @@ -275,7 +390,7 @@ ``` -<h4 id='2.1'>2.3鏍规嵁鍖哄煙id鍜岃鍗曢噺鏌ヨ鏈嶅姟鏈烘瀯鎺掑悕鎯呭喌</h4> +<h4 id='5.4'>5.4鏍规嵁鍖哄煙id鍜岃鍗曢噺鏌ヨ鏈嶅姟鏈烘瀯鎺掑悕鎯呭喌</h4> ###### 鎺ュ彛鍔熻兘 > 鏍规嵁鍖哄煙id鍜岃鍗曢噺鏌ヨ瀹為檯鏈嶅姟鎺掑悕鎯呭喌 @@ -301,7 +416,7 @@ ``` java ``` -<h4 id='2.1'>2.4鎵ц涓鍗�</h4> +<h4 id='5.5'>5.5鎵ц涓鍗�</h4> ###### 鎺ュ彛鍔熻兘 > 鎵ц涓鍗� -- Gitblit v1.9.1