线下店潮流之旅--活动套餐.md 24.6 KB

Raw Blame History Permalink



线下店潮流之旅--活动/套餐


目录

根据活动获取有几个可预约时间 ActivityConfigController/getAppointTime4Activity

一、潮流课堂、活动：

1、获取未结束活动列表：ActivityConfigController/getActivityNowList

2、获取已结束活动列表：ActivityConfigController/getActivityEndList

3、根据活动id获取图文详情：ActivityConfigController/getFrontDetailById

4、根据活动id获取该活动可预约时间等预约信息：ActivityConfigController/getAppointInfoById

5、根据id和预约日期获取该天剩余预约人数信息:ActivityConfigController/getAppointNumById

二、潮流顾问：

1、获取潮流顾问列表（同列表接口，不同活动类型入参）：ActivityConfigController/getActivityList

2、根据潮流顾问id获取详情：ActivityConfigController/getFrontActivityInfoById

3、获取所有潮流顾问可预约时间：ActivityConfigController/getAppointDateForTour

4、根据日期获取可预约时间：ActivityConfigController/getAppointTimeForTour

三、剪发：

1、根据发型师id获取套餐列表（同列表接口，不同活动类型入参）：ActivityConfigController/getActivityList

2、根据套餐id获取活动详情：ActivityConfigController/getFrontActivityInfoById

3、获取所有发型师所有套餐可预约日期：ActivityConfigController/getAppointDateForTour

4、根据发型师Id和日期获取可预约时间：ActivityConfigController/getAppointTimeForTour

四、摄影

1、获取套餐列表（同列表接口，不同活动类型入参）：ActivityConfigController/getActivityList

2、根据id获取套餐详情：ActivityConfigController/getFrontActivityInfoById


返回参数说明


参数名称
参数类型
长度
备注


id
int
11
活动id


activityType
int
11
活动类型：1-潮流课堂，2-活动，3-潮流顾问，4-摄影套餐，5-发型师套餐


activityName
String
100
活动名称/套餐名称


activityStartDate
String
10
活动开始日期


activityEndDate
String
10
活动结束日期


activityDayStartTime
String
8
活动每天开始时间


activityDayEndTime
String
8
活动每天结束时间


image
String
1000
活动图片


price
String
100
活动价格


isFree
int
11
是否免费：1-是，0-否


summary
String
1000
简介


detail
String
1000
详情


styleNumber
int
11
可选风格数


styleList
String
1000
可选风格列表


isAppointment
int
11
是否需要预约：0-否，1-是


appointStatus
int
11
预约状态：1-可预约，2-已约满


appointNum
int
11
每天可预约人数


appointRemainNum
int
11
该天剩余可预约人数


startDate
String
10
预约开始日期


endDate
String
10
预约结束日期


startTime
String
8
每天预约开始时间


endTime
String
10
每天预约结束时间


type
int
11
活动类型：1-潮流课堂，2-活动，3-潮流顾问，4-摄影套餐，5-发型师套餐,6-菜单内容配置-潮流之旅


appointWeeks
String
20
可预约星期


appointTimeList
List>

可预约时间(日期、星期对应)


一、潮流课堂、活动


1、获取未结束活动列表

入口：ActivityConfigController/getActivityNowList

请求参数


参数名称
参数类型
长度
可否为空
示例
默认值
备注


storeId
int
11
否


门店id


activityType
int
11
否


活动类型：1-潮流课堂，2-活动


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

http://172.16.6.207:8080/portal-gateway/ActivityConfigController/getActivityNowList

  {
   "storeId": "66",
   "activityType":1
 }


响应

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

 {
  "code": 200,
  "message": "success",
  "data": [
  {
  "id": 26,
  "activityType": 1,
  "storeName": null,
  "activityName": "活动1",
  "isAppointment": 0,
  "activityStartDate": "2016/12/22",
  "activityEndDate": "2016/12/28",
  "activityDayStartTime": "17:49:00",
  "activityDayEndTime": "20:49:00",
  "startDate": null,
  "endDate": null,
  "startTime": null,
  "endTime": null,
  "price": null,
  "image": "http://img11.static.yhbimg.com/yhb-img01/2016/12/15/17/0135f8ca88ab58b4a5944e555eb5f82f5d.png",
  "detail": "<p>发生地方是否</p>",
  "consultantName": "哈哈",
  "summary": "",
  "styleNumber": null,
  "styleList": null,
  "appointWeeks": null,
  "appointMinutes": null,
  "activityTimeStr": null,
  "appointTimeStr": null,
  "isFree": 1,
  "appointStatus": null
},
{
  "id": 22,
  "activityType": 1,
  "storeName": null,
  "activityName": "活动不预约",
  "isAppointment": 1,
  "activityStartDate": "2016/12/20",
  "activityEndDate": "2016/12/25",
  "activityDayStartTime": "10:09:00",
  "activityDayEndTime": "10:09:00",
  "startDate": null,
  "endDate": null,
  "startTime": "17:25:00",
  "endTime": "17:27:00",
  "price": "125.0",
  "image": "http://img11.static.yhbimg.com/yhb-img01/2016/12/15/15/01e01d0cc16b8de236d123ada39c33ef02.png",
  "detail": "<p>不需要预约<img src=\"http://img11.static.yhbimg.com/yhb-img01/2016/12/15/15/01a03bead63ab234e579d539c0740243ee.jpg\" title=\"\" alt=\"\" width=\"264\" height=\"150\"/></p>",
  "consultantName": "",
  "summary": "",
  "styleNumber": null,
  "styleList": null,
  "appointWeeks": null,
  "appointMinutes": null,
  "activityTimeStr": null,
  "appointTimeStr": null,
  "isFree": 0,
  "appointStatus": 1
}
]
}


其他

{
 "code": 201,
 "message": "门店id为空",
 "data": null
}

{
 "code": 201,
 "message": "活动类型为空",
 "data": null
}

{
 "code": 201,
 "message": "活动类型无效",
 "data": null
}


2、获取已结束活动列表

入口：ActivityConfigController/getActivityEndList

请求参数


参数名称
参数类型
长度
可否为空
示例
默认值
备注


storeId
int
11
否


门店id


activityType
int
11
否


活动类型：1-潮流课堂，2-活动


请求示例

注意，通用的头部没有列出。

http://172.16.6.207:8080/portal-gateway/ActivityConfigController/getActivityEndList

  {
   "storeId": "66",
   "activityType":1
 }


响应

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

 {
  "code": 200,
  "message": "success",
  "data": [
{
  "id": 20,
  "activityType": 1,
  "storeName": null,
  "activityName": "活动免费",
  "isAppointment": 1,
  "activityStartDate": "2016/12/15",
  "activityEndDate": "2016/12/20",
  "activityDayStartTime": "15:00:17",
  "activityDayEndTime": "15:00:17",
  "startDate": null,
  "endDate": null,
  "startTime": "15:06:00",
  "endTime": "16:07:34",
  "price": null,
  "image": "http://img10.static.yhbimg.com/yhb-img01/2016/12/15/18/0199df31bbf80ab677f73cf35a06def2ac.jpg,http://img10.static.yhbimg.com/yhb-img01/2016/12/15/18/0123a4c070e520e56a02b4abb3e173b808.png,http://img11.static.yhbimg.com/yhb-img01/2016/12/15/18/01f83a0ce0d84f69fe8151e04d0df8a0ab.jpg",
  "detail": "<p>活动免费<img src=\"http://img10.static.yhbimg.com/yhb-img01/2016/12/15/15/01cfbd57dc7080623d3494f65421473dac.png\" title=\"\" alt=\"\"/></p>",
  "consultantName": "",
  "summary": "",
  "styleNumber": null,
  "styleList": null,
  "appointWeeks": null,
  "appointMinutes": null,
  "activityTimeStr": null,
  "appointTimeStr": null,
  "isFree": 1,
  "appointStatus": null
}
]
}


其他

 {
 "code": 201,
 "message": "门店id为空",
 "data": null
}

{
 "code": 201,
 "message": "活动类型为空",
 "data": null
}

{
 "code": 201,
 "message": "活动类型无效",
 "data": null
}


3、根据活动id获取图文详情

入口：ActivityConfigController/getFrontDetailById

请求参数


参数名称
参数类型
长度
可否为空
示例
默认值
备注


activityId
int
11
否


活动id


请求示例

注意，通用的头部没有列出。

http://172.16.6.207:8080/portal-gateway/ActivityConfigController/getFrontDetailById

  {
   "activityId":20
  }


响应

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

{
 "code": 200,
 "message": "success",
 "data": {
   "activityId": 20,
   "detail": "<p>活动免费<img src=\"http://img10.static.yhbimg.com/yhb-img01/2016/12/15/15/01cfbd57dc7080623d3494f65421473dac.png\" title=\"\" alt=\"\"/></p>"
  }
}


其他

{
 "code": 201,
 "message": "参数错误 ",
 "data": null
}

{
 "code": 201,
 "message": "活动id为空",
 "data": null
}


4、根据活动id获取该活动可预约时间等预约信息

入口：ActivityConfigController/getAppointInfoById

请求参数


参数名称
参数类型
长度
可否为空
示例
默认值
备注


activityId
int
11
否


活动id


activityType
int
11
否


活动类型:1-潮流课堂，2-活动，3-潮流顾问，4-摄影套餐，5-发型师套餐


isFront
int
11
否


是否前台表


请求示例

注意，通用的头部没有列出。

http://172.16.6.207:8080/portal-gateway/ActivityConfigController/getAppointInfoById

  {
   "activityId":22，
   "activityType":1,
   "isFront":1
 }


响应

   {
      "code": 200,
      "message": "success",
      "data": {
        "12月27日": "周二",
        "12月28日": "周三",
        "12月29日": "周四"
      }
    }


5、根据id和预约日期获取该天剩余预约人数信息

入口：ActivityConfigController/getAppointNumById

请求参数


参数名称
参数类型
长度
可否为空
示例
默认值
备注


activityId
int
11
否


活动id


appointDay
string
50
否


预约日期，格式：yyyy-MM-dd


appointNum
int
11
否


该日期可预约人数


请求示例

注意，通用的头部没有列出。

http://172.16.6.207:8080/portal-gateway/ActivityConfigController/getAppointInfoById

{
"activityId":22,
"appointDay":"2016-12-23",
"appointNum":5
}


响应

 {
  "code": 200,
  "message": "success",
  "data": {
    "appointRemainNum": 5
  }
}


二、潮流顾问


1、获取潮流顾问列表

入口：ActivityConfigController/getActivityList

请求参数


参数名称
参数类型
长度
可否为空
示例
默认值
备注


activityType
int
11
否


活动类型：1-潮流课堂，2-活动，3-潮流顾问，4-摄影套餐，5-发型师套餐


storeId
int
11
否


门店id


hairStylistId
int
11
是


发型师id，根据发型师获取套餐列表时设置该字段有效


请求示例

注意，通用的头部没有列出。

http://172.16.6.207:8080/portal-gateway/ActivityConfigController/getActivityList

{
"activityType":3,
"storeId":66
}


响应

{
 "code": 200,
 "message": "success",
 "data": [
{
  "id": 52,
  "activityType": 5,
  "activityName": "时间套餐",
  "isAppointment": 1,
  "activityStartDate": "",
  "activityEndDate": "",
  "activityDayStartTime": "",
  "activityDayEndTime": "",
  "startDate": null,
  "endDate": null,
  "startTime": null,
  "endTime": null,
  "price": null,
  "image": "",
  "detail": null,
  "consultantName": "",
  "summary": "套餐简介",
  "styleNumber": 0,
  "styleList": "",
  "appointWeeks": null,
  "appointMinutes": null,
  "isFree": 1,
  "appointStatus": null
},
{
  "id": 56,
  "activityType": 5,
  "activityName": "时间预约",
  "isAppointment": 1,
  "activityStartDate": "",
  "activityEndDate": "",
  "activityDayStartTime": "",
  "activityDayEndTime": "",
  "startDate": null,
  "endDate": null,
  "startTime": null,
  "endTime": null,
  "price": "128.0",
  "image": "",
  "detail": null,
  "consultantName": "",
  "summary": "简介",
  "styleNumber": 0,
  "styleList": "",
  "appointWeeks": null,
  "appointMinutes": null,
  "isFree": 0,
  "appointStatus": null
}
]
}


3、获取所有潮流顾问可预约时间

入口：ActivityConfigController/getAppointDateForTour

请求参数


参数名称
参数类型
长度
可否为空
示例
默认值
备注


activityType
int
11
否


活动类型：1-潮流课堂，2-活动，3-潮流顾问，4-摄影套餐，5-发型师套餐


storeId
int
11
否


门店id


isFront
int
11
是
1
1
1


请求示例

注意，通用的头部没有列出。

http://172.16.6.207:8080/portal-gateway/ActivityConfigController/getAppointDateForTour

{
"activityType":3,
"storeId":66,
"isFront":1
}


响应

{
  "code": 200,
  "message": "success",
  "data": {
     "2016/12/21": "周三",
     "2016/12/22": "周四",
     "2016/12/23": "周五",
     "2016/12/24": "周六",
     "2016/12/27": "周二",
     "2016/12/28": "周三",
     "2016/12/29": "周四",
     "2016/12/14": "周三",
     "2016/12/15": "周四",
     "2016/12/16": "周五",
     "2016/12/17": "周六",
     "2016/12/18": "周日",
     "2016/12/19": "周一",
     "2016/12/20": "周二",
     "2016/12/13": "周二",
     "2016/12/25": "周日",
     "2016/12/26": "周一",
     "2016/12/30": "周五",
     "2016/12/31": "周六",
     "2017/01/01": "周日",
     "2017/01/02": "周一",
     "2017/01/03": "周二",
     "2017/01/04": "周三",
     "2017/01/05": "周四",
     "2017/01/06": "周五",
     "2017/01/07": "周六",
     "2017/01/08": "周日",
     "2017/01/09": "周一",
     "2017/01/10": "周二",
     "2017/01/11": "周三"
  }
}


4、根据日期获取所有潮流顾问可预约时间点

入口：ActivityConfigController/getAppointTimeForTour

请求参数


参数名称
参数类型
长度
可否为空
示例
默认值
备注


activityType
int
11
否


活动类型：1-潮流课堂，2-活动，3-潮流顾问，4-摄影套餐，5-发型师套餐


storeId
int
11
否


门店id


isFront
int
11
是
1
1
1


dateTime
String
50
是
2016/12/15

可预约日期


请求示例

注意，通用的头部没有列出。

http://172.16.6.207:8080/portal-gateway/ActivityConfigController/getAppointTimeForTour

{
"activityType":3,
"storeId":66,
"isFront":1,
"dateTime":"2016/12/15"
}


响应

{
  "code": 200,
  "message": "success",
  "data": {
    "appointNum": 20,
    "isAppointNum": 0,
    "timeMap": {
      "1481772300": 1,
      "1481792400": 1,
      "1481794560": 1
    }
  }
}


三、剪发


1、根据发型师id获取套餐列表

入口：ActivityConfigController/getActivityList

请求参数


参数名称
参数类型
长度
可否为空
示例
默认值
备注


activityType
int
11
否


活动类型：1-潮流课堂，2-活动，3-潮流顾问，4-摄影套餐，5-发型师套餐


storeId
int
11
否


门店id


hairStylistId
int
11
是


发型师id，根据发型师获取套餐列表时设置该字段有效


filter
int
11
是


是否过滤已经过期的数据


请求示例

注意，通用的头部没有列出。

http://172.16.6.207:8080/portal-gateway/ActivityConfigController/getActivityList

{
"activityType":5,
"storeId":66,
"hairStylistId" : 6
}


响应

{
 "code": 200,
 "message": "success",
 "data": [
{
  "id": 58,
  "activityType": 5,
  "activityName": "发型师1231",
  "isAppointment": 1,
  "activityStartDate": "0",
  "activityEndDate": "",
  "activityDayStartTime": "",
  "activityDayEndTime": "",
  "price": null,
  "image": "",
  "detail": null,
  "consultantName": "6",
  "summary": "这是套餐简介这是套餐简介这是套餐简介这是套餐简介这是套餐简介这是套餐简介这是套餐简介这是套餐简介这是套餐简介这是套餐简介这是套餐简介这是套餐简介这是套餐简介这是套餐简介这是套餐简介这是套餐简介这是套餐简介这是套餐简介这是套餐简介这是套餐简介这是套餐简介这是套餐简介这是套餐简介这是套餐简介这是套餐简介这是套餐简介这是套餐简介这是套餐简介这是套餐简介这是套餐简介这是套餐简介这是套餐简介这是套餐简介这是套餐简介这是套餐简介这是套餐简介",
  "styleNumber": 0,
  "styleList": "",
  "isFree": 1,
  "appointStatus": null,
  "appointTimeInfo": [
    {
      "appointWeeks": "",
      "linkId": 58,
      "endDate": "",
      "appointNum": 9,
      "startTime": "18:54:00",
      "endTime": "18:56:00",
      "type": 5,
      "startDate": ""
    },
    {
      "appointWeeks": "",
      "linkId": 58,
      "endDate": "",
      "appointNum": 20,
      "startTime": "10:00:37",
      "endTime": "14:00:46",
      "type": 5,
      "startDate": ""
    }
  ],
   "appointTimeList": [
    {
      "2016/12/22": "周四",
      "2016/12/23": "周五"
    }
  ]
 }
]
}


2、根据活动id获取活动详情

入口：ActivityConfigController/getFrontActivityInfoById

请求参数


参数名称
参数类型
长度
可否为空
示例
默认值
备注


activityId
int
11
否


活动id


请求示例

注意，通用的头部没有列出。

http://172.16.6.207:8080/portal-gateway/ActivityConfigController/getFrontActivityInfoById

  {
   "activityId":22
 }


响应

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

  {
  "code": 200,
  "message": "success",
 "data": {
"id": 22,
"activityType": 1,
"activityName": "活动不预约",
"isAppointment": 1,
"activityStartDate": "2016/12/20",
"activityEndDate": "2016/12/25",
"activityDayStartTime": "10:09:00",
"activityDayEndTime": "10:09:00",
"price": "125.0",
"image": "http://img11.static.yhbimg.com/yhb-img01/2016/12/15/15/01e01d0cc16b8de236d123ada39c33ef02.png",
"detail": "<p>不需要预约<img src=\"http://img11.static.yhbimg.com/yhb-img01/2016/12/15/15/01a03bead63ab234e579d539c0740243ee.jpg\" title=\"\" alt=\"\" width=\"264\" height=\"150\"/></p>",
"consultantName": "",
"summary": "",
"styleNumber": 0,
"styleList": "",
"isFree": 0,
"appointStatus": null,
"appointTimeInfo": [
  {
    "appointWeeks": "",
    "linkId": 22,
    "endDate": "",
    "appointNum": 9,
    "startTime": "17:25:00",
    "endTime": "17:27:00",
    "type": 1,
    "startDate": ""
  },
  {
    "appointWeeks": "",
    "linkId": 22,
    "endDate": "",
    "appointNum": 5,
    "startTime": "15:06:00",
    "endTime": "16:07:34",
    "type": 1,
    "startDate": ""
  }
 ]
}
}


其他

   {
    "code": 201,
    "message": "活动id为空",
    "data": null
   }


3、获取发型师所有套餐可预约时间

入口：ActivityConfigController/getAppointDateForTour

请求参数


参数名称
参数类型
长度
可否为空
示例
默认值
备注


activityType
int
11
否


活动类型：1-潮流课堂，2-活动，3-潮流顾问，4-摄影套餐，5-发型师套餐


storeId
int
11
否


门店id


isFront
int
11
是
1
1
1


hairStylistId
int
11
否
1
1
发型师id


请求示例

注意，通用的头部没有列出。

http://172.16.6.207:8080/portal-gateway/ActivityConfigController/getAppointDateForTour

{
"activityType":5,
"storeId":66,
"isFront":1，
"hairStylistId":4
}


响应

{
  "code": 200,
  "message": "success",
  "data": {
     "2016/12/21": "周三",
     "2016/12/22": "周四",
     "2016/12/23": "周五",
     "2016/12/24": "周六",
     "2016/12/27": "周二",
     "2016/12/28": "周三",
     "2016/12/29": "周四",
     "2016/12/14": "周三",
     "2016/12/15": "周四",
     "2016/12/16": "周五",
     "2016/12/17": "周六",
     "2016/12/18": "周日",
     "2016/12/19": "周一",
     "2016/12/20": "周二",
     "2016/12/13": "周二",
     "2016/12/25": "周日",
     "2016/12/26": "周一",
     "2016/12/30": "周五",
     "2016/12/31": "周六",
     "2017/01/01": "周日",
     "2017/01/02": "周一",
     "2017/01/03": "周二",
     "2017/01/04": "周三",
     "2017/01/05": "周四",
     "2017/01/06": "周五",
     "2017/01/07": "周六",
     "2017/01/08": "周日",
     "2017/01/09": "周一",
     "2017/01/10": "周二",
     "2017/01/11": "周三"
  }
}


4、根据日期获取所有潮流顾问可预约时间点

入口：ActivityConfigController/getAppointTimeForTour

请求参数


参数名称
参数类型
长度
可否为空
示例
默认值
备注


activityType
int
11
否


活动类型：1-潮流课堂，2-活动，3-潮流顾问，4-摄影套餐，5-发型师套餐


storeId
int
11
否


门店id


isFront
int
11
是
1
1
1


dateTime
String
50
是
2016/12/15

可预约日期


hairStylistId
int
11
否
1
1
发型师id


请求示例

注意，通用的头部没有列出。

http://172.16.6.207:8080/portal-gateway/ActivityConfigController/getAppointTimeForTour

{
"activityType":5,
"storeId":66,
"isFront":1,
"dateTime":"2016/12/15",
"hairStylistId":4
}


响应

{
  "code": 200,
  "message": "success",
  "data": {
    "appointNum": 20,
    "isAppointNum": 0,
    "timeMap": {
      "1481772300": 1,
      "1481792400": 1,
      "1481794560": 1
    }
  }
}


根据活动获取有几个可预约时间

入口：/ActivityConfigController/getAppointTime4Activity

请求参数


参数名称
参数类型
长度
可否为空
示例
默认值
备注


activityType
int
11
否


活动类型：1-潮流课堂，2-活动，3-潮流顾问，4-摄影套餐，5-发型师套餐


isFront
int
11
是
1
1
1


activityId
int
11
否
123

活动 id


请求示例

注意，通用的头部没有列出。

http://192.168.102.210:8080/portal-gateway/ActivityConfigController/getAppointTime4Activity?debug=XYZ&isFront=1&activityId=62&activityType=9

说明 ：

如果只有一个时间返回时间戳，多个返回空字符串

响应

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

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