/room/lock/id

下单锁定歌厅包房, 支付之前先调用该接口锁房,支付成功后需要在5分钟内调用room/payed/id接口通知,否则将自动把房间解锁

URL

https://api.ktvsky.com/room/lock/id,id为歌厅的唯一标示ID

支持格式

JSON

HTTP请求方式

GET

请求参数

参数 必选 类型及范围 说明
order_id true string 贵方平台生成的唯一订单ID
itemid true int 包房所属的活动类型ID
roomtypeid true int 包房类型ID
begintime true string 预订包房的开始时间,例如:2015-09-27 22:00,只支持整点和半点时间预订。只允许预订15分钟后的包房
is_fix false int 按时段方式购买还是按买断方式购买,默认采用按时段方式购买0。如果按买断方式购买,则为1
date true string 营业日期,和获取房价的日期一致,例如:2015-09-27,和begintime的日期不一定一致
arrive_time false string 用户预估到店时间,例如:2015-09-27 21:30
hours false float 如果采用买断方式购买,不需要此参数。预订的小时数,半小时起订,n * 0.5
user_name false string 预订用户的用户名字
mobile true string 预订用户的手机号
remark true string 预订套餐信息
fee true decimal 用户在贵方平台已支付的费用
app_key true string 创建应用时,系统分配的APP KEY
nonce true string 随机生成的字符串
signature true string 签名,关于签名算法,参见签名算法说明

返回字段说明

返回值字段 字段类型 字段说明
order_id string 歌厅订单编号
mobile string 订房用户的手机号

错误码说明

参见全局返回码说明