# 线下店潮流之旅--活动/套餐 # # 目录 # 根据活动获取有几个可预约时间 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<Map<String, String>>||可预约时间(日期、星期对应)| ## # 一、潮流课堂、活动 # ## 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": "" }