| Version | Update Time | Status | Author | Description |
|---|---|---|---|---|
0.0.1 | 2023-03-06 17:25:00 | 创建文档 | 浮生 | 初始化接口文档 |
1.
1.1. 获取文件路径链接
Type: POST
Author: 27951
Content-Type: multipart/form-data
Description: 获取文件路径链接
Query-parameters:
| Parameter | Type | Description | Required | Since |
|---|---|---|---|---|
file | file | No comments found.(array of file) | true | - |
Request-example:
curl -X POST -H 'Content-Type: multipart/form-data' -i http://localhost:8888/reporting/file/fileUpDownResponse-fields:
| Field | Type | Description | Since |
|---|---|---|---|
success | boolean | 接口调用结果标识 | - |
message | string | 接口调用结果信息 | - |
code | string | 接口调用业务码 | - |
data | object | 接口调用返回数据 | - |
Response-example:
{
"success": true,
"message": "success",
"code": "72953",
"data": "jxj0y3"
}2. 报备模块
2.1. 信息上传
Type: POST
Author: 27951
Content-Type: application/json; charset=utf-8
Description: 信息上传
Body-parameters:
| Parameter | Type | Description | Required | Since |
|---|---|---|---|---|
name | string | 姓名 | true | - |
phone | string | 手机号 | true | - |
wxPhone | string | 微信绑定手机号 | false | - |
company | string | 单位名称 | true | - |
customerName | string | 客户名称 | true | - |
entryName | string | 项目名称 | true | - |
projectAmount | string | 项目金额 | true | - |
tenderTime | string | 预计投标时间 | true | - |
content | string | 项目基本情况 | false | - |
parameters | string | 控标参数-----新需求 | false | - |
trade | string | 所属行业 | true | - |
licensing | string | 是否授权-----新需求 | true | - |
product | string | No comments found. | false | - |
bProduct | array | 产品类型 | true | - |
bFile | array | No comments found. | false | - |
file | string | No comments found. | false | - |
code | string | No comments found. | false | - |
Request-example:
curl -X POST -H 'Content-Type: application/json; charset=utf-8' -i http://localhost:8888/reporting/informationReporting/add --data '{
"name": "烨磊.汪",
"phone": "17731917897",
"wxPhone": "17731917897",
"company": "雷-张",
"customerName": "烨磊.汪",
"entryName": "烨磊.汪",
"projectAmount": "id0blf",
"tenderTime": "2023-11-06 09:51:28",
"content": "s1qbfq",
"parameters": "ktecx7",
"trade": "w0kkjm",
"licensing": "7ntm4z",
"product": "yus8l8",
"bProduct": [
"dt90td"
],
"bFile": [
"zbtudk"
],
"file": "yplkbv",
"code": "72953"
}'Response-fields:
| Field | Type | Description | Since |
|---|---|---|---|
success | boolean | 接口调用结果标识 | - |
message | string | 接口调用结果信息 | - |
code | string | 接口调用业务码 | - |
data | object | 接口调用返回数据 | - |
Response-example:
{
"success": true,
"message": "success",
"code": "72953",
"data": "49886z"
}2.2. 删除信息
Type: DELETE
Author: 27951
Content-Type: application/json; charset=utf-8
Description: 删除信息
Request-headers:
| Header | Type | Description | Required | Since |
|---|---|---|---|---|
admin_token | string | null | true | - |
Body-parameters:
| Parameter | Type | Description | Required | Since |
|---|---|---|---|---|
id | int64 | 调用者id(管理员 上传信息的人) | false | - |
name | string | 调用者姓名(管理员 上传信息的人) | false | - |
ids | array | id数组 | false | - |
Request-example:
curl -X DELETE -H 'Content-Type: application/json; charset=utf-8' -H 'admin_token' -i http://localhost:8888/reporting/informationReporting/delete --data '{
"id": 900,
"name": "烨磊.汪",
"ids": [
52
]
}'Response-fields:
| Field | Type | Description | Since |
|---|---|---|---|
success | boolean | 接口调用结果标识 | - |
message | string | 接口调用结果信息 | - |
code | string | 接口调用业务码 | - |
data | object | 接口调用返回数据 | - |
Response-example:
{
"success": true,
"message": "success",
"code": "72953",
"data": "uzd2f3"
}2.3. 关闭项目
Type: DELETE
Author: 27951
Content-Type: application/json; charset=utf-8
Description: 关闭项目
Request-headers:
| Header | Type | Description | Required | Since |
|---|---|---|---|---|
admin_token | string | null | true | - |
Body-parameters:
| Parameter | Type | Description | Required | Since |
|---|---|---|---|---|
id | int64 | 调用者id(管理员 上传信息的人) | false | - |
name | string | 调用者姓名(管理员 上传信息的人) | false | - |
itemId | int64 | 项目id | false | - |
Request-example:
curl -X DELETE -H 'Content-Type: application/json; charset=utf-8' -H 'admin_token' -i http://localhost:8888/reporting/informationReporting/close --data '{
"id": 632,
"name": "烨磊.汪",
"itemId": 24
}'Response-fields:
| Field | Type | Description | Since |
|---|---|---|---|
success | boolean | 接口调用结果标识 | - |
message | string | 接口调用结果信息 | - |
code | string | 接口调用业务码 | - |
data | object | 接口调用返回数据 | - |
Response-example:
{
"success": true,
"message": "success",
"code": "72953",
"data": "50zrgg"
}2.4.
Type: DELETE
Author: "Astrid"
Content-Type: application/json; charset=utf-8
Description:
Request-headers:
| Header | Type | Description | Required | Since |
|---|---|---|---|---|
admin_token | string | null | true | - |
Body-parameters:
| Parameter | Type | Description | Required | Since |
|---|---|---|---|---|
id | int64 | 调用者id(管理员 上传信息的人) | false | - |
name | string | 调用者姓名(管理员 上传信息的人) | false | - |
itemId | int64 | 项目id | false | - |
ps | string | 订阅消息---备注 | false | - |
Request-example:
curl -X DELETE -H 'Content-Type: application/json; charset=utf-8' -H 'admin_token' -i http://localhost:8888/reporting/informationReporting/valid --data '{
"id": 70,
"name": "烨磊.汪",
"itemId": 840,
"ps": "l0h8a2"
}'Response-fields:
| Field | Type | Description | Since |
|---|---|---|---|
success | boolean | 接口调用结果标识 | - |
message | string | 接口调用结果信息 | - |
code | string | 接口调用业务码 | - |
data | object | 接口调用返回数据 | - |
Response-example:
{
"success": true,
"message": "success",
"code": "72953",
"data": "noxwam"
}2.5.
Type: DELETE
Author: "Astrid"
Content-Type: application/json; charset=utf-8
Description:
Request-headers:
| Header | Type | Description | Required | Since |
|---|---|---|---|---|
admin_token | string | null | true | - |
Body-parameters:
| Parameter | Type | Description | Required | Since |
|---|---|---|---|---|
id | int64 | 调用者id(管理员 上传信息的人) | false | - |
name | string | 调用者姓名(管理员 上传信息的人) | false | - |
itemId | int64 | 项目id | false | - |
ps | string | 订阅消息---备注 | false | - |
Request-example:
curl -X DELETE -H 'Content-Type: application/json; charset=utf-8' -H 'admin_token' -i http://localhost:8888/reporting/informationReporting/invalid --data '{
"id": 802,
"name": "烨磊.汪",
"itemId": 431,
"ps": "zrjs6f"
}'Response-fields:
| Field | Type | Description | Since |
|---|---|---|---|
success | boolean | 接口调用结果标识 | - |
message | string | 接口调用结果信息 | - |
code | string | 接口调用业务码 | - |
data | object | 接口调用返回数据 | - |
Response-example:
{
"success": true,
"message": "success",
"code": "72953",
"data": "uyg27t"
}2.6. 项目列表
Type: GET
Author: 27951
Content-Type: application/x-www-form-urlencoded;charset=utf-8
Description: 项目列表
Request-headers:
| Header | Type | Description | Required | Since |
|---|---|---|---|---|
admin_token | string | null | true | - |
Query-parameters:
| Parameter | Type | Description | Required | Since |
|---|---|---|---|---|
name | string | 姓名 | false | - |
company | string | 单位名称 | false | - |
trade | string | 所属行业 | false | - |
delStatus | int32 | 删除状态:0删除 1正常 | false | - |
status | int32 | 项目状态:0已关闭 1进行中 | false | - |
reportingTime | string | 创建时间 | false | - |
currPage | int32 | 当前页,默认1 | false | - |
pageSize | int32 | 每页大小,默认10 | false | - |
orderField | string | 排序字段,可选择值参考返回结果 | false | - |
order | string | 排序方式,可选值:asc、desc | false | - |
Request-example:
curl -X GET -H 'admin_token' -i http://localhost:8888/reporting/informationReporting/list?currPage=1&orderField=6rh3qr&reportingTime=2023-11-06 09:51:28&trade=gcijtx&status=423&company=雷-张&pageSize=10&name=烨磊.汪&order=r217st&delStatus=889Response-fields:
| Field | Type | Description | Since |
|---|---|---|---|
success | boolean | 接口调用结果标识 | - |
message | string | 接口调用结果信息 | - |
code | string | 接口调用业务码 | - |
data | object | 接口调用返回数据 | - |
└─totalCount | int32 | 总记录数 | - |
└─pageSize | int32 | 每页记录数 | - |
└─totalPage | int32 | 总页数 | - |
└─currPage | int32 | 当前页数 | - |
└─list | array | 列表数据 | - |
└─id | int64 | id | - |
└─userName | string | 用户名 | - |
└─name | string | 管理员姓名 | - |
└─password | string | 密码 | - |
└─adminType | int32 | 角色类别 1超级管理员、2管理员 | - |
└─time | string | 创建时间 | - |
└─status | int32 | 状态(0停用 1正常) | - |
Response-example:
{
"success": true,
"message": "success",
"code": "72953",
"data": {
"totalCount": 941,
"pageSize": 10,
"totalPage": 1,
"currPage": 1,
"list": [
{
"id": 406,
"userName": "烨磊.汪",
"name": "烨磊.汪",
"password": "ouiqq4",
"adminType": 535,
"time": "2023-11-06 09:51:28",
"status": 540
}
]
}
}2.7. 信息导出
Type: GET
Author: 27951
Content-Type: application/x-www-form-urlencoded;charset=utf-8
Description: 信息导出
Query-parameters:
| Parameter | Type | Description | Required | Since |
|---|---|---|---|---|
ids | array | id数组 | false | - |
name | string | 姓名 | false | - |
company | string | 单位名称 | false | - |
trade | string | 所属行业 | false | - |
status | int32 | 状态:0删除 1进行中 2已关闭 | false | - |
reportingTime | string | 创建时间 | false | - |
Request-example:
curl -X GET -i http://localhost:8888/reporting/informationReporting/download?company=雷-张&reportingTime=2023-11-06 09:51:28&ids=5dxtk9&ids=5dxtk9&name=烨磊.汪&trade=uqq1s6&status=356Response-example:
Doesn't return a value.3. 账户管理模块
3.1. 管理员登录
Type: POST
Content-Type: application/json; charset=utf-8
Description: 管理员登录
Body-parameters:
| Parameter | Type | Description | Required | Since |
|---|---|---|---|---|
userName | string | 用户名 | true | - |
password | string | 密码 | true | - |
Request-example:
curl -X POST -H 'Content-Type: application/json; charset=utf-8' -i http://localhost:8888/reporting/user/login --data '{
"userName": "烨磊.汪",
"password": "25aigc"
}'Response-fields:
| Field | Type | Description | Since |
|---|---|---|---|
success | boolean | 接口调用结果标识 | - |
message | string | 接口调用结果信息 | - |
code | string | 接口调用业务码 | - |
data | object | 接口调用返回数据 | - |
└─id | int64 | id | - |
└─userName | string | 用户名 | - |
└─name | string | 管理员姓名 | - |
└─password | string | 密码 | - |
└─adminType | int32 | 角色类别 1超级管理员、2管理员 | - |
└─time | string | 创建时间 | - |
└─status | int32 | 状态(0停用 1正常) | - |
Response-example:
{
"success": true,
"message": "success",
"code": "72953",
"data": {
"id": 410,
"userName": "烨磊.汪",
"name": "烨磊.汪",
"password": "wch5nb",
"adminType": 922,
"time": "2023-11-06 09:51:28",
"status": 688
}
}3.2. 添加管理员
Type: POST
Content-Type: application/json; charset=utf-8
Description: 添加管理员
Request-headers:
| Header | Type | Description | Required | Since |
|---|---|---|---|---|
admin_token | string | null | true | - |
Body-parameters:
| Parameter | Type | Description | Required | Since |
|---|---|---|---|---|
id | int64 | id | false | - |
userName | string | 用户名 | true | - |
name | string | 管理员姓名 | true | - |
password | string | 密码 | false | - |
Request-example:
curl -X POST -H 'Content-Type: application/json; charset=utf-8' -H 'admin_token' -i http://localhost:8888/reporting/user/add --data '{
"id": 179,
"userName": "烨磊.汪",
"name": "烨磊.汪",
"password": "rbmfqc"
}'Response-fields:
| Field | Type | Description | Since |
|---|---|---|---|
success | boolean | 接口调用结果标识 | - |
message | string | 接口调用结果信息 | - |
code | string | 接口调用业务码 | - |
data | object | 接口调用返回数据 | - |
Response-example:
{
"success": true,
"message": "success",
"code": "72953",
"data": "ngus85"
}3.3. 删除管理员
Type: DELETE
Content-Type: application/json; charset=utf-8
Description: 删除管理员
Request-headers:
| Header | Type | Description | Required | Since |
|---|---|---|---|---|
admin_token | string | null | true | - |
Body-parameters:
| Parameter | Type | Description | Required | Since |
|---|---|---|---|---|
ids | array | id数组 | false | - |
Request-example:
curl -X DELETE -H 'Content-Type: application/json; charset=utf-8' -H 'admin_token' -i http://localhost:8888/reporting/user/delete --data '{
"ids": [
91
]
}'Response-fields:
| Field | Type | Description | Since |
|---|---|---|---|
success | boolean | 接口调用结果标识 | - |
message | string | 接口调用结果信息 | - |
code | string | 接口调用业务码 | - |
data | object | 接口调用返回数据 | - |
Response-example:
{
"success": true,
"message": "success",
"code": "72953",
"data": "8u3zdi"
}3.4. 修改管理员信息
Type: PUT
Content-Type: application/json; charset=utf-8
Description: 修改管理员信息
Request-headers:
| Header | Type | Description | Required | Since |
|---|---|---|---|---|
admin_token | string | null | true | - |
Body-parameters:
| Parameter | Type | Description | Required | Since |
|---|---|---|---|---|
id | int64 | id | false | - |
userName | string | 用户名 | true | - |
name | string | 管理员姓名 | true | - |
password | string | 密码 | false | - |
Request-example:
curl -X PUT -H 'Content-Type: application/json; charset=utf-8' -H 'admin_token' -i http://localhost:8888/reporting/user/update --data '{
"id": 422,
"userName": "烨磊.汪",
"name": "烨磊.汪",
"password": "ml6sp9"
}'Response-fields:
| Field | Type | Description | Since |
|---|---|---|---|
success | boolean | 接口调用结果标识 | - |
message | string | 接口调用结果信息 | - |
code | string | 接口调用业务码 | - |
data | object | 接口调用返回数据 | - |
Response-example:
{
"success": true,
"message": "success",
"code": "72953",
"data": "4tajsv"
}3.5. 修改本人密码
Type: PUT
Content-Type: application/json; charset=utf-8
Description: 修改本人密码
Request-headers:
| Header | Type | Description | Required | Since |
|---|---|---|---|---|
admin_token | string | null | true | - |
Body-parameters:
| Parameter | Type | Description | Required | Since |
|---|---|---|---|---|
id | int64 | 当前登录管理员id | true | - |
password | string | 原密码,密码使用公钥加密后传输 | true | - |
newPassword | string | 新密码,密码使用公钥加密后传输 | true | - |
Request-example:
curl -X PUT -H 'Content-Type: application/json; charset=utf-8' -H 'admin_token' -i http://localhost:8888/reporting/user/updatePassword --data '{
"id": 440,
"password": "vklpmk",
"newPassword": "wmfx92"
}'Response-fields:
| Field | Type | Description | Since |
|---|---|---|---|
success | boolean | 接口调用结果标识 | - |
message | string | 接口调用结果信息 | - |
code | string | 接口调用业务码 | - |
data | object | 接口调用返回数据 | - |
Response-example:
{
"success": true,
"message": "success",
"code": "72953",
"data": "x08sft"
}3.6. 管理员列表
Type: GET
Content-Type: application/x-www-form-urlencoded;charset=utf-8
Description: 管理员列表
Request-headers:
| Header | Type | Description | Required | Since |
|---|---|---|---|---|
admin_token | string | null | true | - |
Query-parameters:
| Parameter | Type | Description | Required | Since |
|---|---|---|---|---|
userName | string | 用户名 | false | - |
name | string | 管理员姓名 | false | - |
time | string | 创建时间 | false | - |
currPage | int32 | 当前页,默认1 | false | - |
pageSize | int32 | 每页大小,默认10 | false | - |
orderField | string | 排序字段,可选择值参考返回结果 | false | - |
order | string | 排序方式,可选值:asc、desc | false | - |
Request-example:
curl -X GET -H 'admin_token' -i http://localhost:8888/reporting/user/list?name=烨磊.汪&time=2023-11-06 09:51:28&orderField=bb50au&pageSize=10&userName=烨磊.汪&order=b14694&currPage=1Response-fields:
| Field | Type | Description | Since |
|---|---|---|---|
success | boolean | 接口调用结果标识 | - |
message | string | 接口调用结果信息 | - |
code | string | 接口调用业务码 | - |
data | object | 接口调用返回数据 | - |
└─totalCount | int32 | 总记录数 | - |
└─pageSize | int32 | 每页记录数 | - |
└─totalPage | int32 | 总页数 | - |
└─currPage | int32 | 当前页数 | - |
└─list | array | 列表数据 | - |
└─id | int64 | id | - |
└─userName | string | 用户名 | - |
└─name | string | 管理员姓名 | - |
└─password | string | 密码 | - |
└─adminType | int32 | 角色类别 1超级管理员、2管理员 | - |
└─time | string | 创建时间 | - |
└─status | int32 | 状态(0停用 1正常) | - |
Response-example:
{
"success": true,
"message": "success",
"code": "72953",
"data": {
"totalCount": 172,
"pageSize": 10,
"totalPage": 1,
"currPage": 1,
"list": [
{
"id": 324,
"userName": "烨磊.汪",
"name": "烨磊.汪",
"password": "s997jb",
"adminType": 945,
"time": "2023-11-06 09:51:29",
"status": 515
}
]
}
}4. 获取微信绑定手机号
4.1. 通过code换取用户手机号
Type: GET
Content-Type: application/x-www-form-urlencoded;charset=utf-8
Description: 通过code换取用户手机号
Query-parameters:
| Parameter | Type | Description | Required | Since |
|---|---|---|---|---|
code | string | No comments found. | false | - |
state | string | No comments found. | false | - |
Request-example:
curl -X GET -i http://localhost:8888/reporting/wx/getPhone?code=72953&state=4cylgoResponse-fields:
| Field | Type | Description | Since |
|---|---|---|---|
success | boolean | 接口调用结果标识 | - |
message | string | 接口调用结果信息 | - |
code | string | 接口调用业务码 | - |
data | object | 接口调用返回数据 | - |
Response-example:
{
"success": true,
"message": "success",
"code": "72953",
"data": "u3ua1v"
}4.2. 获取用户在微信中的openid
Type: GET
Content-Type: application/x-www-form-urlencoded;charset=utf-8
Description: 获取用户在微信中的openid
Query-parameters:
| Parameter | Type | Description | Required | Since |
|---|---|---|---|---|
code | string | 用户授权后得到的code | false | - |
Request-example:
curl -X GET -i http://localhost:8888/reporting/wx/getOpenId?code=72953Response-example:
string