喵社区 修改说明

2015年11月4日16:20:38
接口文档

返回数据修改

1.回复我的 和我回复的接口新增字段masterContent表示当前回复所回复的主体对象
2.商品详情接口 新增commentNum 字段 表示 评论数

提交订单

修改说明：
1. 去掉商家店铺相关
2. 原地址尚可使用
3. 只修改参数json字符串

接口地址
POST /order/buyed
请求参数

响应结果

{
    code: 0, //0 - 接口调用成功，其他值表示失败
    message: "30.75",//订单金额
    data:"2313213"//订单号
}

周边送商品列表

修改说明：
1. 去掉返回列表对象中的sellerId 和 sellerName

接口地址
GET /surrounding/commodity/list
请求参数
*不变*
响应结果

{
    code: 0, //0 - 接口调用成功，其他值表示失败
    message: "",
    data:[{//去掉sellerId 和 sellerName},...]
}

周边送商品详情

修改说明：
1. 去掉返回对象中的sellerId 和 sellerName

接口地址
GET /surrounding/commodity/{id}

路径参数
id int 商品ID
请求参数
无
响应结果

{
    code: 0, //0 - 接口调用成功，其他值表示失败
    message: "",
    data:{//去掉sellerId 和 sellerName}
}

生鲜购商品列表

修改说明：
1. 去掉返回列表对象中的sellerId 和 sellerName

接口地址
GET /fresh/commodity/list
请求参数
*不变*
响应结果

{
    code: 0, //0 - 接口调用成功，其他值表示失败
    message: "",
    data:[{//去掉sellerId 和 sellerName},...]
}

生鲜购商品详情

修改说明：
1. 去掉返回对象中的sellerId 和 sellerName

接口地址
GET /fresh/commodity/{id}

路径参数
id int 商品ID
请求参数
无
响应结果

{
    code: 0, //0 - 接口调用成功，其他值表示失败
    message: "",
    data:{//去掉sellerId 和 sellerName}
}

特卖团商品列表

修改说明：
1. 去掉返回列表对象中的sellerId 和 sellerName

接口地址
GET /special/commodity/list
请求参数
*不变*
响应结果

{
    code: 0, //0 - 接口调用成功，其他值表示失败
    message: "",
    data:[{//去掉sellerId 和 sellerName},...]
}

特卖团商品详情

修改说明：
1. 去掉返回对象中的sellerId 和 sellerName

接口地址
GET /special/commodity/{id}

路径参数
id int 商品ID
请求参数
无
响应结果

{
    code: 0, //0 - 接口调用成功，其他值表示失败
    message: "",
    data:{//去掉sellerId 和 sellerName}
}

订单列表

修改说明：
订单列表需求变化 根据table返回不同的订单列表

接口地址
GET /order/list

路径参数
无
请求参数

其他说明

//APP前端显示的订单状态
0,  "待支付"
5,  "待发货"
6,  "配送中"
9,  "无法送达"
10, "退款中"
12, "待评价"
13, "已完成"
14, "已取消"

响应结果

{
//同原来的接口
}

系统启动整合接口

修改说明：
返回对象中新加Sale

接口地址
GET /system

路径参数
无
请求参数
参数|数据类型|必填|参数说明
---|-------|----|-----
和先前一致

其他说明

响应结果

{
{
    "code": 0,
    "message": null,
    "data": {
        "cityId": 0,
        "cityName": null,
        "communityId": 0,
        "communityName": null,
        "freshMoney": "0.02",
        "freshDeliver": "0.01",
        "specailMoney": "0.02",
        "specailDeliver": "0.01",
        "surroundingMoney": "0.02",
        "surroundingFee": "0.01",
        "noticeId": 0,
        "notice": "暂无",
        "cityTel": "",
        "carouses": [],
        "sale": {
            "id": 19,
            "name": "湘福农湘莲子 手工去芯红莲250g+白莲250g湖南湘潭正宗土特产干货",
            "startTime": "2015-10-14 21:10:06"
        }
    }
}
}

美食狂欢

修改说明：

接口地址
GET /system/recommend/surrounding

路径参数
无
请求参数

其他说明
无
响应结果
和商品一致

{
    "code": 0,
    "message": null,
    "data": [
        {
            "id": 39,
            "name": "皮蛋瘦肉粥",
            "price": 3,
            "sold": 0,
            "categoryId": 1,
            "icon": "http://121.41.76.50/upfile/attachment/208",
            "images": [
                "http://192.168.1.107:8080/zhai-api/attachment/209"
            ],
            "type": 1,
            "enabled": true,
            "description": null,
            "createTime": "2015-08-27 22:45:14",
            "endTime": null,
            "stock": 20,
            "unit": "碗",
            "usedCard": false,
            "star": 0,
            "collected": false,
            "style": 0
        },
        ...
    ]
}

水果派对

修改说明：

接口地址
GET /system/recommend/fresh

路径参数
无
请求参数

其他说明
无
响应结果

//同美食狂欢

星期六

修改说明：

接口地址
GET /system/recommend/special

路径参数
无
请求参数

其他说明
无
响应结果

//同美食狂欢

修改订单支付方式

修改说明：

接口地址
POST /order/paytype

路径参数
无
请求参数

其他说明
返回code说明：

609  支付方式不正确
604 不存在的订单
605 当前订单支付状态不可改变
....

响应结果

//同美食狂欢

猜你喜欢

接口地址
GET /system/liked

路径参数
无
请求参数

其他说明
返回code说明：

....

响应结果

//同美食狂欢

今日是否签到

接口地址
GET /profle/signed

路径参数
无
请求参数

其他说明
返回code说明：

....

响应结果

{
   "code": 0,
    "message": null,
    "data":false
}

用户签到

接口地址
POST /profle/singin

路径参数
无
请求参数

其他说明

积分暂定规则：
初始积分：x
连续签到 10--20天 积分 2*x
连续签到30天以上 3*x

返回code说明：

804:用户已签到
404：用户不存在

响应结果

{
   "code": 0,
    "message": null,
    "data":50//签到获得的积分
}

服务介绍页

接口地址
GET /system/introduction

路径参数
无
请求参数

其他说明
返回code说明：

响应结果

  {
    "code": 0,
    "message": null,
    "data": {
        "id": 1,
        "type": 1,
        "icon": "http://121.41.76.50/upfile/attachment/180",
        "content": "包裹代收.....<br>包裹代收你值得拥有！"
    }
}

申请售后

接口地址
POST /order/aftersale

路径参数
无
请求参数

其他说明
返回code说明：

404  用户不存在
604 订单不存在
607 当前订单不可申请售后(只有待评价的本人的订单可申请)

响应结果

{
    "code": 0,
    "message": null,
    "data": null
}

小区距离

接口地址
GET /system/distance

路径参数
无
请求参数

其他说明

返回code说明：

507  小区不存在

响应结果

{
    "code": 0,
    "message": null,
    "data": 4//单位千米
}

办事指南列表

接口地址
GET /system/guide/list

路径参数
无
请求参数

其他说明

返回code说明：

响应结果

{
    "code": 0,
    "message": null,
    "data": [
        {
            "id": 1,
            "title": "如何打酱油",
            "content": null,
            "createTime": "2015-00-11 16:00"
        },
        ...
    ]
}

办事指南详情

接口地址
GET /system/guide/{id}

路径参数
id:办事指南id
请求参数

其他说明

返回code说明：

响应结果

{
    "code": 0,
    "message": null,
    "data": {
        "id": 1,
        "title": "如何打酱油",
        "content": "这是一个问题",
        "createTime": "2015-00-11 16:00"
    }
}

镖局费用价格

接口地址
GET /system/express/price

路径参数
无
请求参数

其他说明

返回code说明：

响应结果

{
    "code": 0,
    "message": null,
    "data": {
        "baseFee": 5,//起始2.5公里费用
        "unitFee": 1.5//每公里费用
    }
}

社区新闻列表

接口地址
GET /community/news/list

路径参数
无
请求参数

其他说明

返回code说明：

响应结果

{
    "code": 0,
    "message": null,
    "data": [
        {
            "id": 1,
            "title": "xinwen 1",
            "content": null,
            "createTime": "2015-12-19 11:16:15",
            "communityId": 8,
            "comminityName": "水墨兰亭"
        },
        ...
    ]
}

社区新闻详情

接口地址
GET /community/news/{id}

路径参数
id:新闻id
请求参数

其他说明

返回code说明：

响应结果

{
    "code": 0,
    "message": null,
    "data": {
        "id": 1,
        "title": "xinwen 1",
        "content": "111111111111111111111112222222222222",
        "createTime": "2015-12-19 11:16:15",
        "communityId": 8,
        "comminityName": "水墨兰亭"
    }
}

社区通知列表

接口地址
GET /community/notice/list

路径参数
无
请求参数

其他说明

返回code说明：

响应结果

{
    "code": 0,
    "message": null,
    "data": [
        {
            "id": 11,
            "title": "水墨兰亭即将上线，敬请期待！",
            "content": null,
            "createTime": "2015-08-28 13:18:31",
            "communityId": 8,
            "comminityName": "水墨兰亭"
        },...
    ]
}

社区通知详情

接口地址
GET /community/notice/{id}

路径参数
id:通知id
请求参数

其他说明
返回code说明：

响应结果

{
    "code": 0,
    "message": null,
    "data": {
        "id": 11,
        "title": "水墨兰亭即将上线，敬请期待！",
        "content": "水墨兰亭即将上线，敬请期待！",
        "createTime": "2015-08-28 13:18:31",
        "communityId": 8,
        "comminityName": "水墨兰亭"
    }
}

小区物业

接口地址
GET /community/wuye

路径参数
无
请求参数

其他说明
wuye 单词不会写
返回code说明：

```
**响应结果** 
```javascript
{
    "code": 0,
    "message": null,
    "data": {
        "id": 1,
        "communityId": 8,
        "company": "哞哞物业",
        "workTime": "18点-24点",
        "location": "合肥市经开区",
        "mobile": "15600009999"
    }
}
<div class="md-section-divider"></div>

小区居委会

接口地址
GET /community/juweihui

路径参数
无
请求参数

其他说明
juweihui 单词不会写
返回code说明：

<div class="md-section-divider"></div>

响应结果

{
    "code": 0,
    "message": null,
    "data": {
        "id": 1,
        "communityId": 8,
        "communitys": "水墨兰亭,天鹅湖畔",
        "workTime": "9:00-20:00",
        "location": "天鹅湖畔",
        "mobile": "15012345678"
    }
}
<div class="md-section-divider"></div>

线下用户付款

接口地址
POST /lineserver/buy

路径参数
无
请求参数

其他说明

返回code说明：

406 无法解析的字符串
404 用户不存在
402 商户不存在
901无效的代金券（是否存在 是否过期 是否面值正确  是否已经使用）
<div class="md-section-divider"></div>

响应结果

{
    "code": 0,
    "message": null,
    "data":"C1234555"//收款单号-订单号
}
<div class="md-section-divider"></div>

线下评论商家服务

接口地址
POST /lineserver/comment

路径参数
无
请求参数

其他说明

返回code说明：

响应结果

{
    "code": 0,
    "message": null,
    "data": null
}
<div class="md-section-divider"></div>

线下收款支付宝回调

接口地址
/lineserver/alipayCallback

<div class="md-section-divider"></div>

线下收款微信回调

接口地址
/lineserver/wxpayCallback

线下商家端

登陆

接口地址
POST /lineserver/login

路径参数
无
请求参数

其他说明
测试账号1.mobile-18796325896 密码-111111
返回code说明：

403 用户禁用
<div class="md-section-divider"></div>

响应结果

{
    "code": 0,
    "message": null,
    "data": {
        "id": 1,
        "name": "VIC",
        "mobile": "18796325896",
        "type": 0,
        "description": "是是是",
        "cityId": 110,
        "cityName": "合肥市",
        "status": 1,
        "qrCode": "http://121.41.76.50/upfile/attachment/4",//二维码地址
        "serverMobile": "0551-66667777",
        "pushKey": "123456"
    }
}
<div class="md-section-divider"></div>

修改密码

接口地址
POST /lineserver/passwd

路径参数
无
请求参数

其他说明

返回code说明：

401-用户不存在
424 密码不正确
<div class="md-section-divider"></div>

响应结果

{
    "code": 0,
    "message": null,
    "data": null
}
<div class="md-section-divider"></div>

线下服务单列表

接口地址
GET /lineserver/appointment/list

路径参数
无
请求参数

其他说明

返回code说明：

<div class="md-section-divider"></div>

响应结果

{
    "code": 0,
    "message": null,
    "data": [
        {
            "id": 1,
            "appointmentno": "1234566",//预约号
            "type": 1,
            "appointmentTime": 1449849600000,//预约时间
            "mobile": "15056920791",
            "address": "hefeishixinhuacun",
            "remark": "test",
            "lineServerId": 1,
            "cityId": 110,
            "status": 1,
            "createTime": 1481040000000//创建时间
        },
        ...
    ]
}
<div class="md-section-divider"></div>

拒单

接口地址
POST /lineserver/appointment/refuse

路径参数
无
请求参数

其他说明

返回code说明：

505  不存在的预约、或当前预约不属于此商家
504 当前预约单不可做此操作
<div class="md-section-divider"></div>

响应结果

{
    "code": 0,
    "message": null,
    "data": null
}
<div class="md-section-divider"></div>

接单

接口地址
POST /lineserver/appointment/receiving

路径参数
无
请求参数

其他说明

返回code说明：

505  不存在的预约、或当前预约不属于此商家
504 当前预约单不可做此操作
<div class="md-section-divider"></div>

响应结果

{
    "code": 0,
    "message": null,
    "data": null
}
<div class="md-section-divider"></div>

确认回访

接口地址
POST /lineserver/appointment/visit

路径参数
无
请求参数

其他说明

返回code说明：

505  不存在的预约、或当前预约不属于此商家
504 当前预约单不可做此操作
<div class="md-section-divider"></div>

响应结果

{
    "code": 0,
    "message": null,
    "data": null
}
<div class="md-section-divider"></div>

完成服务

接口地址
POST /lineserver/appointment/finish

路径参数
无
请求参数

其他说明

返回code说明：

505  不存在的预约、或当前预约不属于此商家
504 当前预约单不可做此操作
<div class="md-section-divider"></div>

响应结果

{
    "code": 0,
    "message": null,
    "data": null
}
<div class="md-section-divider"></div>

取消订单

接口地址
POST /lineserver/appointment/cancle

路径参数
无
请求参数

其他说明

返回code说明：

505  不存在的预约、或当前预约不属于此商家
504 当前预约单不可做此操作
<div class="md-section-divider"></div>

响应结果

{
    "code": 0,
    "message": null,
    "data": null
}
<div class="md-section-divider"></div>

收款列表

接口地址
GET /lineserver/cash/list

路径参数
无
请求参数

其他说明

返回code说明：

<div class="md-section-divider"></div>

响应结果

{
    "code": 0,
    "message": null,
    "data": [
        {
            "id": 1,
            "cashno": "2134555",//单号
            "payType": 1,//支付方式
            "totalFee": 12,//总金额
            "createTime": 1449651781000,//创建时间
            "commentStar": 4,//评星
            "commentContent": "bucuo bucuo",//评价内容
            "cardValue": 2,//代金券面值
            "mobile": "15056920791"//用户电话
        },
        ...
    ]
}
<div class="md-section-divider"></div>

收款详情

接口地址
GET /lineserver/cash/{id}

路径参数
id 收款单的id
请求参数

其他说明

返回code说明：

<div class="md-section-divider"></div>

响应结果

{
    "code": 0,
    "message": null,
    "data": {
        "id": 1,
        "cashno": "2134555",
        "payType": 1,
        "totalFee": 12,
        "createTime": 1449651781000,
        "commentStar": 4,
        "commentContent": "bucuo bucuo",
        "cardValue": 2,
        "mobile": "15056920791"
    }
}
<div class="md-section-divider"></div>

我的预约列表(线下收款记录)

接口地址
GET /profle/lineserver/list

路径参数

请求参数

其他说明

返回code说明：

<div class="md-section-divider"></div>

响应结果

{
    "code": 0,
    "message": null,
    "data": [
        {
            "id": 1,
            "cashno": "2134555",//服务号
            "payType": 1,
            "totalFee": 12,
            "createTime": "2015-03-09 09:03",
            "commentStar": 4,//评星
            "commentContent": "bucuo bucuo",//评论
            "cardValue": 2,//代金券面值
            "cardId": 0,
            "mobile": "15056920791",//用户电话
            "linServerId": 0,
            "customerId": 0,
             "type": 1,//类型  同介绍页
            "lineServer": "VIC"//商家
        }，...
    ]
}
<div class="md-section-divider"></div>

我的预约详情(线下收款记录)

接口地址
GET /profle/lineserver/{id}

路径参数
id:预约id
请求参数
参数|数据类型|必填|参数说明
---|-------|----|-----
其他说明
返回code说明：

<div class="md-section-divider"></div>

响应结果

{
    "code": 0,
    "message": null,
    "data":{
        //同列表
    }
}
<div class="md-section-divider"></div>

解除用户关系/取消关注/取消屏蔽2016年3月28日

接口地址
POST /bbs/unbind

路径参数
无
请求参数

其他说明
返回code说明：

响应结果

{
    "code": 0,
    "message": null,
    "data":null
}
<div class="md-section-divider"></div>

测试推送接口

接口地址
GET /jpush/test

路径参数
无
请求参数

其他说明
返回code说明：

<div class="md-section-divider"></div>

响应结果

{
  false
}
<div class="md-section-divider"></div>

个人中心

接口地址
GET /profle/index

路径参数
无
请求参数

其他说明

 访问回复我的(回帖) 的时候 把回复我的帖子和@我的帖子未读的置为已读
 访问我的私信列表的时候 把给我私信以及回复我的私信的未读的置为已读
<div class="md-section-divider"></div>

返回code说明：

404
<div class="md-section-divider"></div>

响应结果

{
    "code": ​0,
    "message": null,
    "data": 
    {
        "principal": ​323,//当前登录用户id
        "replyNum": ​0,//回复我的未读数量
        "letterNum": ​1,//私信我的未读数量
        "signable": false,//是否可签到
        "score": ​5110,//我的积分数
        "comunityId": ​44,//我所在小区id
        "comunityName": "金口岭东村"//我的小区名称
    }
}
<div class="md-section-divider"></div>

OrderJson

提交的订单信息 对象说明

{
    system:2,//订单标识 1-周边送 2-生鲜购 3-特卖团
    payType:1,;//支付方式 1-支付宝 2-网银在线 3-货到付款
    addressId : 1//配送地址ID
    customerId：1,//用户id
    communityId:1,//小区id
    cityId:110,//城市id
    style:1;//生鲜购特有：1-预售 2-团购
    totalFee:5.00//总费用,
    cardId:1,//抵用券id
    cardValue:5,//抵用券值
    deliveryFee:10.00,//配送费
    remark:"多加饭,没零钱,不要辣",//备注
    commodities:[
        {
            id:21,  //商品ID
            name:"苹果", //商品名称
            quantity:10    //商品数量
            price:10.00//单价
        },
        ...
    ]
}
<div class="md-section-divider"></div>

CashJson

提交的线下单信息 对象说明

{
    payType:1,;//支付方式 1-支付宝 2-网银在线 3-货到付款 4-微信支付
    totalFee:5.00//总费用,
    cardId:1,//抵用券id
    cardValue:5,//抵用券值
    linServerId：1,//商户id
}