注意:
所有接口需要传入 Head信息,格式如下
参数 说明 类型 是否必须
appKey App Key String Y 开发者账号创建授权接入
clientTime 访问时间毫秒数 Int Y在30分钟内有效
version 客户端版本 String Y 固定值V1.0
signature 签名串 String Y
签名串生成规则见1.4.1签名算法
3.1.1 查询欠款信息
(1) 方法:
路径:/api/receive/list
类型:GET接口
(2) 接口参数
参数 说明 类型 是否必须
access_token string 是 token
phone string N 客户手机号
roomId string N 房间ID, 手机号和房间ID必须具备1个
pid string 是 小区id N
(3) 返回结果
{
"code": 0,
"data": {
"total": 300, 总金额
"list": [
{
id :账单ID
projectName :小区名
pid : 小区id
roomName:房号
buildingName:楼栋
customerName:客户名称
property : 1 住宅 2商业
period:月份,如 2017-01
moneydefineName: 费用名称 ,如物业管理费
amount : 金额
penalty : 违约金
},
],
}
"msg": "成功",
"result": "success",
"success": true
}
3.1.2 缴款成功通知
(1) 方法:
路径:/api/receive/notify
类型:POST接口
特别注意: 账单ID多个必须属于1个客户。 不能是不同客户。 有客户迁入迁出,1个房间的费用计算到不同的客户,建议分两次调用接口。
本接口提交的账单必须是一个小区的
(2) 接口参数
参数 说明 类型 是否必须
pid string 是 小区id Y (3.1.1 接口有返回,每个账单都有pid )
access_token string 是 token
id string 是 账单ID,(多个账单英文,号分隔)
billno string 是 交易流水号
transDate 否 交易日期 ,格式 ‘2018-01-01’
amount 缴费金额
(3) 返回结果
{
"code": 0,
"data": {
}
"msg": "成功",
"result": "success",
"success": true
}