基本使用说明 ================== 整体使用流程及架构思想 ~~~~~~~~~~~~~~~~~~~~~~~~ 在使用网上购票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 当出现此异常时多为平台网站发生未知变化,需及时反馈后台人员