Lianxun_Java.git

编辑 | blame | 历史 | 原始文档

2.7.1 说明

2.7.2 投诉建议

接口功能

用户通过web端或APP 添加投诉建议接口

URL

http://api.java110.com:8008/api/complaint.saveComplaint

支持格式

JSON

HTTP请求方式

POST

请求参数(header部分)

参数名称	约束	类型	长度	描述	取值说明
app_id	1	String	30	应用ID	Api服务分配
transaction_id	1	String	30	请求流水号	不能重复 1000000000+YYYYMMDDhhmmss+6位序列

|sign|1|String|-|签名|请参考签名说明|
|req_time|1|String|-|请求时间|YYYYMMDDhhmmss|

请求参数

参数名称	约束	类型	长度	描述	取值说明
typeCd	1	String	12	投诉类型	投诉809001 建议 809002

|roomId|1|String|20|房间ID|-|
|complaintName|1|String|200|投诉人|-|
|tel|1|String|11|投诉人电话|-|
|context|1|String|500|投诉内容|-|
|userId|1|String|30|用户ID|-|
|storeId|1|String|30|投诉商户ID|这里目前先考虑投诉物业|
|photos|1|Array|-|相关照片，base64格式|-|

返回协议

当http返回状态不为200 时请求处理失败 body内容为失败的原因

当http返回状态为200时请求处理成功，body内容为返回内容，

成功

举例

地址：http://api.java110.com:8008/api/complaint.saveComplaint

请求头信息：
Content-Type:application/json
USER_ID:1234
APP_ID:8000418002
TRANSACTION_ID:10029082726
REQ_TIME:20181113225612
SIGN:aabdncdhdbd878sbdudn898
请求报文：
{
    "typeCd":"809001",
    "roomId":"752019100758260005",
    "complaintName":"吴学文",
    "tel":"17797173942",
    "context":"服务太差",
    "userId":"1292827282727",
    "storeId":"402019032924930007",
    "photos":['base64....'],
}

返回报文：
成功

2.7.3 查询投诉建议

接口功能

用户通过web端或APP查询投诉建议接口

URL

,http://api.java110.com:8008/api/complaint.listComplaints

支持格式

JSON

HTTP请求方式

GET

请求参数(header部分)

参数名称	约束	类型	长度	描述	取值说明
app_id	1	String	30	应用ID	Api服务分配
transaction_id	1	String	30	请求流水号	不能重复 1000000000+YYYYMMDDhhmmss+6位序列

|sign|1|String|-|签名|请参考签名说明|
|req_time|1|String|-|请求时间|YYYYMMDDhhmmss|

请求参数(url部分)

参数名称	约束	类型	长度	描述	取值说明

|page|1|-|30|页数|-|
|row|1|-|30|每页显示行数|-|
|communityId|1|-|30|小区ID|-|
|complaintId|1|-|30|投诉ID|-|
|complaintId|1|-|30|投诉ID|-|
|typeCd|1|-|30|投诉类型|-|
|complaintName|1|-|30|投诉人姓名|-|

返回协议

当http返回状态不为200 时请求处理失败 body内容为失败的原因

当http返回状态为200时请求处理成功，body内容为返回内容

举例

地址：http://api.java110.com:8008/api/complaint.listComplaints?storeTypeCd=800900000003&storeId=402019032924930007&userName=wuxw&userId=30518940136629616640&complaintId=111&typeCd=809002&complaintName=111&page=1&row=10&communityId=7020181217000001

请求头信息：
Content-Type:application/json
USER_ID:1234
APP_ID:8000418002
TRANSACTION_ID:10029082726
REQ_TIME:20181113225612
SIGN:aabdncdhdbd878sbdudn898
请求报文：

无

返回报文：
{
	"complaints": [{
		"complaintId": "882019110351910002",
		"complaintName": "测试工作流",
		"context": "测试工作流",
		"roomId": "752019100965690010",
		"state": "10001",
		"stateName": "处理中",
		"storeId": "402019032924930007",
		"tel": "17797173945",
		"typeCd": "809001",
		"typeCdName": "投诉"
	}, {
		"complaintId": "882019110394400002",
		"complaintName": "测试工作流",
		"context": "测试工作流",
		"roomId": "752019100758260005",
		"state": "10001",
		"stateName": "处理中",
		"storeId": "402019032924930007",
		"tel": "18909874444",
		"typeCd": "809001",
		"typeCdName": "投诉"
	}, {
		"complaintId": "882019110312520003",
		"complaintName": "吴学文",
		"context": "测试工作流",
		"roomId": "752019102597030030",
		"state": "10001",
		"stateName": "处理中",
		"storeId": "402019032924930007",
		"tel": "18909782345",
		"typeCd": "809001",
		"typeCdName": "投诉"
	}],
	"page": 0,
	"records": 4,
	"rows": 0,
	"total": 37
}

2.7.4 删除投诉建议

接口功能

用户通过web端或APP 删除建议接口

URL

http://api.java110.com:8008/api/complaint.deleteComplaint

支持格式

JSON

HTTP请求方式

POST

请求参数(header部分)

参数名称	约束	类型	长度	描述	取值说明
app_id	1	String	30	应用ID	Api服务分配
transaction_id	1	String	30	请求流水号	不能重复 1000000000+YYYYMMDDhhmmss+6位序列

|sign|1|String|-|签名|请参考签名说明|
|req_time|1|String|-|请求时间|YYYYMMDDhhmmss|

请求参数

参数名称	约束	类型	长度	描述	取值说明

|complaintId|1|String|30|投诉ID|-|
|typeCd|1|String|30|投诉类型|-|
|stateName|1|String|30|处理状态名称|-|
|typeCdName|1|String|50|投诉类型名称|-|
|context|1|String|longtext|投诉内容|-|
|complaintName|1|String|30|投诉人|-|
|tel|1|String|11|电话|-|
|state|1|String|-|状态|-|
|storeId|1|String|-|商户ID|-|
|communityId|1|String|-|小区ID|-|
|roomId|1|String|-|房间ID|-|

返回协议

当http返回状态不为200 时请求处理失败 body内容为失败的原因

当http返回状态为200时请求处理成功，body内容为返回内容，

成功

举例

地址：http://api.java110.com:8008/api/complaint.deleteComplaint

请求头信息：
Content-Type:application/json
USER_ID:1234
APP_ID:8000418002
TRANSACTION_ID:10029082726
REQ_TIME:20181113225612
SIGN:aabdncdhdbd878sbdudn898
请求报文：
{
	"complaintId": "882019110351910002",
	"typeCd": "809001",
	"stateName": "处理中",
	"typeCdName": "投诉",
	"context": "测试工作流",
	"complaintName": "测试工作流",
	"tel": "17797173945",
	"state": "10001",
	"storeId": "402019032924930007",
	"communityId": "7020181217000001",
	"roomId": "752019100965690010"
}

返回报文：
成功

2.7.5 查询投诉历史单

接口功能

查询历史投诉单接口

URL

http://api.java110.com:8008/api/auditUser.listAuditHistoryComplaints

支持格式

JSON

HTTP请求方式

GET

请求参数(header部分)

参数名称	约束	类型	长度	描述	取值说明
app_id	1	String	30	应用ID	Api服务分配
transaction_id	1	String	30	请求流水号	不能重复 1000000000+YYYYMMDDhhmmss+6位序列

|sign|1|String|-|签名|请参考签名说明|
|req_time|1|String|-|请求时间|YYYYMMDDhhmmss|

请求参数(url部分)

参数名称	约束	类型	长度	描述	取值说明

|page|1|-|30|页数|-|
|row|1|-|30|每页显示行数|-|
|storeId|1|-|30|商户ID|-|
|userId|1|-|30|用户ID|-|
|communityId|1|-|30|小区ID|-|

返回协议

当http返回状态不为200 时请求处理失败 body内容为失败的原因

当http返回状态为200时请求处理成功，body内容为返回内容

举例

地址：,http://api.java110.com:8008/api/auditUser.listAuditHistoryComplaints?page=1&row=10&communityId=7020181217000001&storeId=402019032924930007&userId=30518940136629616640

请求头信息：
Content-Type:application/json
USER_ID:1234
APP_ID:8000418002
TRANSACTION_ID:10029082726
REQ_TIME:20181113225612
SIGN:aabdncdhdbd878sbdudn898
请求报文：

无

返回报文：
{
	"complaints": [{
		"complaintId": "882019110564340012",
		"complaintName": "七七",
		"context": "七七",
		"roomId": "752019100965690010",
		"state": "10001",
		"stateName": "处理中",
		"storeId": "402019032924930007",
		"tel": "13323654562",
		"typeCd": "809001",
		"typeCdName": "投诉"
	}, {
		"complaintId": "882019110670850021",
		"complaintName": "审批人历史单查询",
		"context": "审批人历史单查询",
		"roomId": "752019100965690010",
		"state": "10002",
		"stateName": "处理完成",
		"storeId": "402019032924930007",
		"tel": "18909716666",
		"typeCd": "809002",
		"typeCdName": "建议"
	}],
	"page": 0,
	"records": 3,
	"rows": 0,
	"total": 28
}

2.7.6 报修

接口功能

用户通过打电话，或APP小程序上登记报修功能

URL

http://api.java110.com:8008/api/ownerRepair.saveOwnerRepair

支持格式

JSON

HTTP请求方式

POST

请求参数(header部分)

参数名称	约束	类型	长度	描述	取值说明
app_id	1	String	30	应用ID	Api服务分配
transaction_id	1	String	30	请求流水号	不能重复 1000000000+YYYYMMDDhhmmss+6位序列

|sign|1|String|-|签名|请参考签名说明|
|req_time|1|String|-|请求时间|YYYYMMDDhhmmss|

请求参数

参数名称	约束	类型	长度	描述	取值说明
repairType	1	String	12	报修类型	卧室报修 10001 管道报修 10002 客厅报修 10003

|repairName|1|String|64|报修人名称|-|
|tel|1|String|11|手机号|-|
|roomId|1|String|30|房屋ID|-|
|appointmentTime|1|String|-|预约时间| 格式为 YYYY-MM-DD hh24:mi:ss|
|context|1|String|200|报修内容|-|
|communityId|1|String|30|小区ID|-|
|photos|1|Array|-|相关照片，base64格式|-|

返回协议

当http返回状态不为200 时请求处理失败 body内容为失败的原因

当http返回状态为200时请求处理成功，body内容为返回内容，

成功

举例

地址：http://api.java110.com:8008/api/ownerRepair.saveOwnerRepair

请求头信息：
Content-Type:application/json
USER_ID:1234
APP_ID:8000418002
TRANSACTION_ID:10029082726
REQ_TIME:20181113225612
SIGN:aabdncdhdbd878sbdudn898

请求报文：
{
    "repairType":"10001",
    "roomId":"752019100758260005",
    "repairName":"吴学文",
    "tel":"17797173942",
    "context":"服务太差",
    "communityId":"702019120393220007",
    "appointmentTime":"2019-12-14 18:30:30",
    "photos":['base64....'],
}

返回报文：
成功

2.7.7 删除报修

接口功能

删除报修信息接口

URL

待补充

支持格式

JSON

HTTP请求方式

POST

请求参数(header部分)

参数名称	约束	类型	长度	描述	取值说明
app_id	1	String	30	应用ID	Api服务分配
transaction_id	1	String	30	请求流水号	不能重复 1000000000+YYYYMMDDhhmmss+6位序列

|sign|1|String|-|签名|请参考签名说明|
|req_time|1|String|-|请求时间|YYYYMMDDhhmmss|

请求参数

参数名称	约束	类型	长度	描述	取值说明

|repairId|1|String|30|报修ID|-|

返回协议

当http返回状态不为200 时请求处理失败 body内容为失败的原因

当http返回状态为200时请求处理成功，body内容为返回内容，

成功

举例

地址：带补充

请求头信息：
Content-Type:application/json
USER_ID:1234
APP_ID:8000418002
TRANSACTION_ID:10029082726
REQ_TIME:20181113225612
SIGN:aabdncdhdbd878sbdudn898

请求报文：
{
	待补充
}

返回报文：
成功

2.7.8 查询报修单

接口功能

用户APP小程序上查询报修

URL

http://api.java110.com:8008/api/ownerRepair.listOwnerRepairs

支持格式

JSON

HTTP请求方式

GET

请求参数(header部分)

参数名称	约束	类型	长度	描述	取值说明
app_id	1	String	30	应用ID	Api服务分配
transaction_id	1	String	30	请求流水号	不能重复 1000000000+YYYYMMDDhhmmss+6位序列

|sign|1|String|-|签名|请参考签名说明|
|req_time|1|String|-|请求时间|YYYYMMDDhhmmss|

请求参数

参数名称	约束	类型	长度	描述	取值说明

|roomId|1|String|30|房屋ID|-|
|communityId|1|String|30|小区ID|-|
|page|1|int|-|分页页数|-|
|row|1|int|-|每页展示数量|-|

返回协议

当http返回状态不为200 时请求处理失败 body内容为失败的原因

当http返回状态为200时请求处理成功，body内容为返回内容，

成功

举例

地址：http://api.java110.com:8008/api/ownerRepair.listOwnerRepairs?communityId=7020181217000001&roomId=752019100758260005&page=1&row=10

请求头信息：
Content-Type:application/json
USER_ID:1234
APP_ID:8000418002
TRANSACTION_ID:10029082726
REQ_TIME:20181113225612
SIGN:aabdncdhdbd878sbdudn898

请求报文：

无

返回报文：
{
	"ownerRepairs": [{
		"appointmentTime": "2019-12-14 18:30:30",
		"context": "服务太差",
		"repairId": "822019121623590070",
		"repairName": "吴学文",
		"repairType": "10001",
		"repairTypeName": "卧室报修",
		"roomId": "752019100758260005",
		"state": "1000",
		"stateName": "未派单",
		"tel": "17797173942"
	}, {
		"appointmentTime": "2019-12-14 18:30:30",
		"context": "服务太差",
		"repairId": "822019121683520071",
		"repairName": "吴学文",
		"repairType": "10001",
		"repairTypeName": "卧室报修",
		"roomId": "752019100758260005",
		"state": "1000",
		"stateName": "未派单",
		"tel": "17797173942"
	}],
	"page": 0,
	"records": 1,
	"rows": 0,
	"total": 2
}

2.7.9 查询发布信息

接口功能

用户通过web端或APP查询活动接口

URL

待补充

支持格式

JSON

HTTP请求方式

GET

请求参数(header部分)

参数名称	约束	类型	长度	描述	取值说明
app_id	1	String	30	应用ID	Api服务分配
transaction_id	1	String	30	请求流水号	不能重复 1000000000+YYYYMMDDhhmmss+6位序列

|sign|1|String|-|签名|请参考签名说明|
|req_time|1|String|-|请求时间|YYYYMMDDhhmmss|

请求参数(url部分)

参数名称	约束	类型	长度	描述	取值说明

|page|-|-|-|当前页|-|
|row|-|-|-|每页显示的行数|-|

返回协议

当http返回状态不为200 时请求处理失败 body内容为失败的原因

当http返回状态为200时请求处理成功，body内容为返回内容，

父参数名称	参数名称	约束	类型	长度	描述	取值说明

|-|-|-|-|-|-|-|

举例

地址：url&page=1&row=10

请求头信息：
Content-Type:application/json
USER_ID:1234
APP_ID:8000418002
TRANSACTION_ID:10029082726
REQ_TIME:20181113225612
SIGN:aabdncdhdbd878sbdudn898
请求报文：

无

返回报文：
{
	待补充
}

2.7.10 查询通知公告

接口功能

查询公告接口

URL

http://api.java110.com:8008/api/notice.listNotices

支持格式

JSON

HTTP请求方式

GET

请求参数(header部分)

参数名称	约束	类型	长度	描述	取值说明
app_id	1	String	30	应用ID	Api服务分配
transaction_id	1	String	30	请求流水号	不能重复 1000000000+YYYYMMDDhhmmss+6位序列

|sign|1|String|-|签名|请参考签名说明|
|req_time|1|String|-|请求时间|YYYYMMDDhhmmss|

请求参数(url部分)

参数名称	约束	类型	长度	描述	取值说明

|page|1|int|-|分页信息，传1|-|
|row|1|int|-|分页信息传10|每页显示数|

返回协议

参数名称	约束	类型	长度	描述	取值说明

|noticeTypeCd|1|string|12|公告类型，1000 业主通知，1001员工通知，1002小区通知|-|
|context|1|string|2000|公告内容|公告内容|
|startTime|1|String|30|公告开始时间|公告开始时间|
|title|1|String|100|公告标题|-|
|communityId|1|String|30|小区ID|-|
|userId|1|String|30|用户ID|发布公告的用户ID|
|noticeId|1|String|30|公告ID|-|

当http返回状态不为200 时请求处理失败 body内容为失败的原因

当http返回状态为200时请求处理成功，body内容为返回内容，

举例

地址：http://api.java110.com:8008/api/notice.listNotices?page=1&row=10

请求头信息：
Content-Type:application/json
USER_ID:1234
APP_ID:8000418002
TRANSACTION_ID:10029082726
REQ_TIME:20181113225612
SIGN:aabdncdhdbd878sbdudn898
请求报文：

无

返回报文：
返回状态码200

{
	"notices": [{
		"context": "<p>dadadada</p>",
		"createTime": "2020-01-20 11:10:13",
		"endTime": "2020-01-29 11:10:06",
		"noticeId": "962020012064620007",
		"noticeTypeCd": "1000",
		"noticeTypeCdName": "业主通知",
		"startTime": "2020-01-20 11:09:53",
		"title": "daadada"
	},{
		"context": "<p>sadfafsd</p>",
		"createTime": "2019-12-28 12:27:12",
		"endTime": "2019-12-28 06:25:58",
		"noticeId": "962019122882540023",
		"noticeTypeCd": "1000",
		"noticeTypeCdName": "业主通知",
		"startTime": "2019-12-28 12:26:40",
		"title": "hdhdf"
	}],
	"page": 0,
	"records": 3,
	"rows": 0,
	"total": 26
}

2.7.10 添加通知公告

接口功能

添加公告接口

URL

http://api.java110.com:8008/api/notice.saveNotice

支持格式

JSON

HTTP请求方式

POST

请求参数(header部分)

参数名称	约束	类型	长度	描述	取值说明
app_id	1	String	30	应用ID	Api服务分配
transaction_id	1	String	30	请求流水号	不能重复 1000000000+YYYYMMDDhhmmss+6位序列

|sign|1|String|-|签名|请参考签名说明|
|req_time|1|String|-|请求时间|YYYYMMDDhhmmss|

请求参数

参数名称	约束	类型	长度	描述	取值说明

|title|1|String|100|通知标题|-|
|noticeTypeCd|1|String|4|类型|1000 业主通知，1001员工通知，1002小区通知|
|context|1|String|longtext|通知内容|-|
|startTime|1|timestamp|-|开始时间|-|
|endTime|1|timestamp|-|结束时间|-|

返回协议

当http返回状态不为200 时请求处理失败 body内容为失败的原因

当http返回状态为200时请求处理成功，body内容为返回内容，

举例

地址：http://api.java110.com:8008/api/notice.saveNotice

请求头信息：
Content-Type:application/json
USER_ID:1234
APP_ID:8000418002
TRANSACTION_ID:10029082726
REQ_TIME:20181113225612
SIGN:aabdncdhdbd878sbdudn898
请求报文：

{
	"noticeTypeCd": "1000",
	"context": "<p>dadadada</p>",
	"startTime": "2020-01-20 11:09:53",
	"endTime": "2020-01-29 11:10:06",
	"title": "daadada",
	"communityId": "7020181217000001",
	"userId": "30518940136629616640"
}

返回报文：