1.实时消息内容
使用MQ进行实时消息传递,传递内容使用json格式。
发送消息的时机:
1.影票订单确认完成,并且营业日期为当天的,发送售票消息(operation: 1)。
2.影票订单确认完成,并且营业日期大于当天的,发送预售消息(operation: 3)。
3.影票订单取消/退订订单发送退票消息(operation:2)。
4.改签操作,系统调用取消订单->锁座->确认订单,则应该发送两次消息,一次取消订单消息,一次销售或预售消息。
1.1 消息字段说明
字段名称 | 字段说明 | 字段类型 | 备注 |
---|---|---|---|
orderId | 服务商系统订单ID | string | 小于等于32个字符 |
businessDate | 营业日期 | string | 格式:yyyy-MM-dd |
cinemaCode | 影院编码 | string | 8位数字字符组成 |
screenCode | 影厅编码 | string | 小于等于16个字符 |
filmCode | 影片编码 | string | 固定12位数字字符组成 |
sessionCode | 场次编码 | string | 小于等于16个字符 |
sessionDateTime | 影片放映时间 | string | 格式:yyyy-MM-ddThh:mm:ss |
ticketCode | 电影票编码 | string | 固定16位数字字符组成 |
seatCode | 座位编码 | string | 小于等于16个字符 |
ticketPrice | 影票价格 | int | 单位:分 |
servicePrice | 网络服务费 | int | 单位:分 |
operation | 操作 | int | 1:售票,2:退票,3:预售 |
operationDateTime | 操作时间 | string | 格式:yyyy-MM-ddThh:mm:ss |
1.2 示例
MQ通道: report.ticket.order
消息内容:
{
"orderId": "TO201709190938451772583",
"businessDate": "2017-10-09",
"cinemaCode": "35012401",
"screenCode": "3",
"filmCode": "077101622017",
"sessionCode": "9191709136J2XP84",
"sessionDateTime ": "2017-09-15T10:30:00",
"ticketCode": "9191709180001799",
"seatCode": "9",
"ticketPrice": "3500",
"servicePrice": "200",
"operation": 1,
"operationDateTime": "2017-09-15T09:32:25"
}
2.历史查询接口
以 HTTP GET 接口形式提供。所有查询条件均非必填字段,可根据需要选择性的进行填写。
2.1 查询参数说明
字段名称 | 字段说明 | 字段类型 | 备注 |
---|---|---|---|
startBusinessDate | 营业日期查询开始时间,营业日期时间上限 | string | 格式:yyyy-MM-dd |
endBusinessDate | 营业日期查询结束时间,营业日期时间下限 | string | 格式:yyyy-MM-dd |
cinemaCode | 影院编码 | string | 固定8位数字字符组成 |
screenCode | 影厅编码 | string | 小于等于16个字符 |
filmCode | 影片编码 | string | 固定12位数字字符组成 |
sessionCode | 场次编码 | string | 小于等于16个字符 |
ticketCode | 电影票编码 | string | 固定16位数字字符组成 |
startDateTime | 查询开始时间,票务操作时间上限 | string | 格式:yyyy-MM-ddThh:mm:ss |
endDateTime | 查询结束时间,票务操作时间下限 | string | 格式:yyyy-MM-ddThh:mm:ss |
2.2 返回字段说明
字段名称 | 字段说明 | 字段类型 | 备注 |
---|---|---|---|
orderId | 服务商系统订单ID | string | 小于等于32个字符 |
businessDate | 营业日期 | string | 格式:yyyy-MM-dd |
cinemaCode | 影院编码 | string | 固定 8位数字字符组成 |
screenCode | 影厅编码 | string | 小于等于16个字符 |
filmCode | 影片编码 | string | 固定12位数字字符组成 |
sessionCode | 场次编码 | string | 小于等于16个字符 |
sessionDateTime | 影片放映时间 | string | 格式:yyyy-MM-ddThh:mm:ss |
ticketCode | 电影票编码 | string | 固定16位数字字符组成 |
seatCode | 座位编码 | string | 小于等于16个字符 |
ticketPrice | 影票价格 | int | 单位:分 |
servicePrice | 网络服务费 | int | 单位:分 |
saleDateTime | 影票销售时间 | string | 格式:yyyy-MM-ddThh:mm:ss |
refundDateTime | 影票退票时间 | string | 格式:yyyy-MM-ddThh:mm:ss |
2.3 返回示例
请求:
curl "http://192.168.10.90:8081/report/ticket/getOrderList?cinemaCode=35012401&startBusinessDate=2017-10-09&endBusinessDate=2017-10-10"
返回:
{
[
{
"orderId ": "TO201709190938451772583",
"businessDate ": "2017-10-09",
"cinemaCode ": "35012401",
"screenCode": "3",
"filmCode": "077101622017",
"sessionCode": "9191709136J2XP84",
"sessionDateTime ": "2017-09-15T10:30:00",
"ticketCode": "9191709180001799",
"seatCode": "9",
"ticketPrice": "3500",
"servicePrice": "200",
"saleDateTime": "2017-09-15T09:32:25"
},
{
"orderId ": "TO201709151453250693641",
"businessDate ": "2017-10-09",
"cinemaCode ": "35012401",
"screenCode": "3",
"filmCode": "077101622017",
"sessionCode": "9191709136J2XP84",
"sessionDateTime ": "2017-09-15T10:30:00",
"ticketCode": "9191709180001802",
"seatCode": "6",
"ticketPrice": "3500",
"servicePrice": "200",
"saleDateTime": "2017-09-15T09:32:25",
"refundDateTime": "2017-09-15T09:32:25"
}
]
}