基本使用说明¶
整体使用流程及架构思想¶
在使用网上购票APP时可抽象为以下筛选流程: 选择城市–>选择影片–>选择影院所在行政区–>选择影院–>显示场次票价 其中第一,第三步通过客户端定位得到简化。本API也遵循此实现逻辑,每层间通过ID号相联系 。即,上层获取的查询结果ID应作为下层的查询参数,客户端需逐层请求以获取最终场次及票价。
空值处理方法¶
部分影片或部分影院会存在非所有平台支持的情况,此时API返回该平台的查询结果ID将为空字符串,客户端接受后 进行下一层查询时可直接不提供该参数,则API会默认不再对该平台进行下一层查询。
异常处理方法¶
因同时请求多家平台,而各平台状态不一致,采取特殊异常反馈方法 从请求电影列表层开始,返回格式均为列表,其中所有返回列表的首个元素为异常反馈列表,例如:
[
[
"meituan unknown error",
"taobao unknown error"
],
{
"nuomi_now_price": "44",
"taobao_now_price": "",
"start_time": "10:00",
"end_time": "11:33",
"meituan_now_price": ""
},
{
"nuomi_now_price": "44",
"taobao_now_price": "",
"start_time": "11:00",
"end_time": "12:33",
"meituan_now_price": ""
},
{
"nuomi_now_price": "44",
"taobao_now_price": "",
"start_time": "11:45",
"end_time": "13:18",
"meituan_now_price": ""
}
]
当各平台均正常时,首个异常反馈列表应为空 当出现异常时,列表中会出现报错信息:
1.某平台连接失败:
XXX connection broken
如仅为单个平台异常,客户端可忽略该平台,并在客户端给出合适反馈即可 当多个平台异常或某平台多次持续连接失败时,需及时反馈后台人员
2.未知错误:
XXX unknown error
当出现此异常时多为平台网站发生未知变化,需及时反馈后台人员