Yoho-Documents / API-Interfaces · Files

Go to a project
线下店潮流之旅--预约.md 5.47 KB

线下店资讯

#一、新增预约#

入口：AppointmentController/addAppointmentRecord

请求参数

参数名称 参数类型 长度 可否为空 示例 默认值 备注
storeId int 11 否 门店id
appointTime int 否 预约时间,10位时间戳
appointUserName string 否 预约人
appointMobile int 否 预约人手机
uid int 否 账号uid
activityId int 否 套餐/活动id
appointContent string 否 预约内容拼接的json字符串
appointPersonNum int 是 预约人数量
userNote string 否 用户备注
styles string 是 风格id，逗号风格

请求示例 注意，通用的头部没有列出。

http://192.168.102.210:8080/portal-gateway/AppointmentController/addAppointmentRecord?debug=XYZ&appointTime=2016& appointStatus=1&appointUserName=name&uid=1234&storeId=66

响应

code为200即为成功，否则是失败。 响应JSON格式如下所示:

 {
  "code": 200,
  "message": "success",
  "data": null
}

#二、我的预约#

入口：AppointmentController/getMyAppointmentList

请求参数

参数名称 参数类型 长度 可否为空 示例 默认值 备注
storeId int 11 否 门店id
uid int 否 账号uid
statusList String 是 2,3,4 1-预约中,2-已完成,3-已取消,4-已过期，逗号分开
id int 是 预约 id

请求示例 注意，通用的头部没有列出。

http://192.168.102.210:8080/portal-gateway/AppointmentController/getMyAppointmentList?debug=XYZ&storeId=66&uid=1234&statusList=1

参数含义：

activityName： 名称；

appointStatusStr：状态

appointTime： 时间

响应

code为200即为成功，否则是失败。 响应JSON格式如下所示:

 {
  "code": 200,
  "message": "success",
  "data": [
    {
      "id": 8,
      "appointTime": "1",
      "appointStatus": 1,
      "appointUserName": "“哈哈”",
      "appointMobile": "",
      "uid": 1234,
      "menuId": 0,
      "activityId": 24,
      "appointContent": null,
      "appointPersonNum": null,
      "achieveNote": null,
      "note": null,
      "userNote": null,
      "cancelReason": null,
      "storeId": 66,
      "appointStatusStr": "预约中",
      "activityName": "潮流课堂:活动2",
      "styles":"1,2"
    }
  ]
}

#三、获取可预约时间#

入口：AppointmentController/getAppointTime

请求参数

参数名称 参数类型 长度 可否为空 示例 默认值 备注
storeId int 11 否 66 门店id
activityId int 否 38 活动id，
appointType int 否 4 预约类型，1-潮流课堂，2-活动，3-潮流顾问，4-摄影套餐，5-发型师套餐,6-菜单内容配置-潮流之旅
dateTime string 否 2016/12/22 日期
isFront int 1 是 是否前台表

请求示例 注意，通用的头部没有列出。

http://192.168.102.210:8080/portal-gateway/AppointmentController/getAppointTime?debug=XYZ&activityId=38&appointType=4&dateTime=2016/12/22&storeId=66&isFront=1

参数含义：

appointNum： 可预约数量；

isAppointNum：已经预约数量

timeMap： 可预约时间列表（map类型，key为时间，value为是否可预约：1可预约，2不可预约）

响应

code为200即为成功，否则是失败。 响应JSON格式如下所示:

    {
      "code": 200,
      "message": "success",
      "data": {
        "appointNum": 0,
        "isAppointNum": 0,
        "timeMap": {
          "1482386880": 1
        }
      }
    }

#四、取消预约 #

入口：AppointmentController/frontCancelAppoint

请求参数

参数名称 参数类型 长度 可否为空 示例 默认值 备注
id int 11 否 66 id
isFront int 1 否 1 是否前台表

请求示例 注意，通用的头部没有列出。

http://localhost:8080/portal-gateway/AppointmentController/frontCancelAppoint?debug=XYZ&id=2&isFront=1 参数含义：

响应

code为200即为成功，否则是失败。 响应JSON格式如下所示:

    {
      "code": 200,
      "message": "success",
      "data": 1
    }

#五 、修改预约时间 #

入口：AppointmentController/updateFrontAppointTime

请求参数

参数名称 参数类型 长度 可否为空 示例 默认值 备注
id int 11 否 8 id
appointTimeStr string 1 否 2017/2/6 09:51 预约时间字符串

请求示例 注意，通用的头部没有列出。

http://localhost:8080/portal-gateway/AppointmentController/updateFrontAppointTime?appointTimeStr=2017/2/6 09:51&id=8&debug=XYZ 参数含义：

响应

code为200即为成功，否则是失败。 响应JSON格式如下所示:

    {
      "code": 200,
      "message": "success",
      "data": 1
    }