>注意:(不关前端测试的事)后台有个定时执行任务,地址为“index.php/Admin/Index/timingImplement”。主要处理的任务有:判断当前竞拍是否结束,
~~~
竞拍的流程:
1:用户发布竞拍【接口:“发布竞拍”】
2:添加完【接口:发布竞拍】以后,在后台“待发布竞拍”可以发布竞拍。
3:在后台发布完竞拍以后,可以调用【接口:获取竞拍列表】查看竞拍列表
4:获取完【接口:获取竞拍列表】,对某个竞拍感兴趣可以调用【接口:获取竞拍详细信息】查看竞拍的详情
5:看过【接口:获取竞拍详细信息】以后,想竞拍该竞拍可以调用【接口:竞拍】参与竞拍该竞拍
~~~
* * * * *
## 发布竞拍
+++
post:Api/Auction/addWait/token/用户TOKEN
city_id=所在市区ID【默认为1 深圳】#
*title=竞拍标题【设计稿没有,需要设计稿添加上去】#
*con_name=委托人姓名 #
*con_tel=委托人联系方式#
large_area=最大需求面积【最大需求面积与最小需求面积必填一个】#
small_area=最小需求面积【最大需求面积与最小需求面积必填一个】#
large_price=最高价格【最高价格与最低价格必填一个】#
small_price=最低价格【最高价格与最低价格必填一个】#
*company_name=公司名称 #
*industry_id=公司行业ID #
settled_time=是否立即入驻 0为立即入驻,为数字的时候表示入驻时间,单位为月。如:3表示3个月入驻 默认为0#
region=委托区域【数组形式】 为空的时候不限制区域#
describe=描述#
<<<
success
返回参数说明:
{
"data": "",
"info": "添加成功",
"code": 1000,
"state": 1
}
<<<
error
{
"data": "",
"info": "业主姓名不可为空",
"code": 1001,
"state": 2
}
可能返回的错误:
代号 错误
998 查询无数据
999 用户未登录
1001 输入的信息有误(提示数据错误原因)
+++
## 获取用户上传的竞拍【我发布的竞拍】
+++
get: Api/Auction/getUserWait/token/用户token
*state=状态 1为未成交,2为已成交。 默认为1(除了2,其他任何数字都为未成交)#
<<<
success
{
"data": [
{
"_id": {
"$id": "58d8da8d4818d6c9129d70de"
},
"title": "222222",
"region": [
"123123"
]
},
{
"_id": {
"$id": "58d8da984818d6c9129d70e0"
},
"title": "222222",
"region": [
"123123"
]
}
],
"info": "查询成功",
"code": 1000,
"state": 1
}
<<<
error
{
"data": "",
"info": "用户未登录",
"code": 999,
"state": 2
}
可能返回的错误:
代号 错误
999 用户未登录
996 查询没有数据
+++
## 将竞拍状态设置为已成交【客户已成交】
+++
get: Api/Auction/complete
*auction_id=竞拍ID#
*state=状态 1为未成交,2为已成交。 默认为1(除了2,其他任何数字都为未成交)#
<<<
success
{
"data": "",
"info": "修改成功",
"code": 1000,
"state": 1
}
<<<
error
{
"data": "",
"info": "用户未登录",
"code": 999,
"state": 2
}
可能返回的错误:
代号 错误
999 用户未登录
997 缺少必须参数
998 修改失败
+++
## 获取竞拍列表【竞拍页面】
+++
get: Api/Auction/getAuctionList
<<<
success
返回参数说明:
正在竞拍的不返回“业主电话” 与“业主姓名”
正在竞拍的:将返回竞拍次数与当前竞拍出价
{
"data": [
{
"_id": {
"$id": "58b39cde74e5f0fc9b84140a"
},
"title": "2", //竞拍标题
"region": [ //区域
"罗湖区"
],
"state": 1, //竞拍状态 1为正在竞拍 9为系统处理中
"release_time": "00:39:05", //竞拍剩余时间
"city": "深圳" //市区
},
],
"info": "查询成功",
"code": 1000,
"state": 1
}
<<<
error
{
"data": "",
"info": "查询无数据",
"code": 996,
"state": 2
}
可能返回的错误:
代号 错误
996 查询无数据
+++
## 获取竞拍详细信息
+++
get: Api/Auction/getAuctionDateils
*auction_id=竞拍ID #
<<<
success
返回参数说明:
正在竞拍的不返回“业主电话” 与“业主姓名”
正在竞拍的:将返回竞拍次数与当前竞拍出价
{
"data": {
"_id": {
"$id": "58db5baaa81e5aaf29f71ecb"
},
"title": " 标题", //标题
"large_area": 22, //最小面积
"small_area": 33, //最大面积
"large_price": 22, //最高需求价格
"small_price": 33, //最低需求价格
"company_name": "读订单", //公司名称
"industry_id": "1", //公司行业ID
"settled_time": 1, //是否立即入驻 为0时为立即入驻,否则单位为月,如:3表示3个月后入驻
"region": [ //区域
"1"
],
"describe": "2", //描述
"release_time": "00:00:00", //竞拍剩余时间
"state": 9, //0为未竞拍,1为可竞拍,2为竞拍结束,且有人参与竞拍 3为竞拍结束,且无人竞拍, 4为竞拍结束,且有人竞拍,但没交保证金, 5,为待签署合同。 6已签署合同 9为系统处理中
"user_info": "", //竞拍成功后的用户详情
"offer": 233, //当前竞拍最高价
"num": 3 //当前竞拍次数
"user_auction_state": 1 //判断当前用户是否竞拍过,0为未竞拍 1为已竞拍
"user_auction_offer": 322 //获取当前用户竞拍出价 0为未竞拍
下面信息是当前用户竞拍成功的才会显示出来
"con_name": 客户名称 //客户名称
"con_tel": 15512345678 //客户电话
},
"info": "查询成功",
"code": 1000,
"state": 1
}
<<<
error
{
"data": "",
"info": "缺少必须参数(ID)",
"code": 997,
"state": 2
}
可能返回的错误:
代号 错误
997 缺少必须参数(ID)
996 未找到该竞拍
+++
## 我参与的竞拍
+++
get: Api/Auction/userAuction/token/用户token
*state=状态 0为未成交,1为已成交(任何数字)。 默认为0#
<<<
success
{
"data": [
{
"_id": {
"$id": "58d8da8d4818d6c9129d70de"
},
"title": "222222", //标题
"region": [ //区域
"123123"
],
"state": 2, //1为正在竞拍,2为竞拍成功,3为竞拍失败,4为竞拍成功但没交保证金, 9为用户自己
"offer": "123" //用户出价
},
{
"_id": {
"$id": "58d8b3bc4818d6c9129d685b"
},
"title": "竞拍竞拍竞拍了!!!",
"region": [
"1",
"2",
"3"
],
"state": 2,
"offer": 222
}
],
"info": "获取成功",
"code": 1000,
"state": 1
}
<<<
error
{
"data": "",
"info": "查询没有数据",
"code": 996,
"state": 2
}
可能返回的错误:
代号 错误
996 查询没有数据
999 用户未登录
+++
## 获取当前用户剩余砖石
+++
get: Api/Auction/userVirtualCurrency/token/用户token
<<<
success
返回参数说明:
{
"data": {
"virtual_currency": "199890" //剩余砖石
},
"info": "获取成功",
"code": 1000,
"state": 1
}
<<<
error
{
"data": "",
"info": "用户未登录",
"code": 999,
"state": 2
}
可能返回的错误:
代号 错误
999 用户未登录
+++
## 竞拍
+++
get: Api/Auction/auction/token/用户token
*auction_id=竞拍ID #
*offer=出价 #
<<<
success
返回参数说明:
{
"data": "",
"info": "竞拍成功,请等待结果",
"code": 1000,
"state": 1
}
<<<
error
{
"data": "",
"info": "竞拍失败,错误代码:998",
"code": 998,
"state": 2
}
可能返回的错误:
代号 错误
996 查无该竞拍
998 竞拍失败,错误代码:998
1001 参数有误
1023 您的砖石不足,请充值
1034 该竞拍未处于可竞拍状态
1035 不可竞拍自己发布的竞拍
+++