如果您拥有其它渠道的预约系统(比如有赞商城,或独立网店),但是希望把这些渠道所收到的订单数据汇集到Darkroom「暗房」 进行统一管理,那么这个API接口正是您所需要的。「暗房」的API接口,目前仅限专业版 商家使用。使用API之前,您需要先联系DR客服生成一对API秘钥。对于中小型机构,我们更建议您直接使用「暗房」官方自带的在线预约模块。
查询一段时间内预约某一个服务项目的所有可用档期:
参数名 | 必须/可选 | 参数类型 | 备注/示例 |
---|---|---|---|
from_date |
必须 |
字符串 |
查询的开始日期示例值:"2018-08-18" |
to_date |
必须 |
字符串 |
查询的结束日期注意:查询的日期跨度不得超过62天示例值:"2018-08-20" |
plan_id |
必须 |
字符串 |
该门店下的某个服务项目的编号示例值:"newborn" |
curl -X GET -d '{"api_key":"ABC", "api_ts":1533435628, "api_sig":"....", "from_date":"2018-06-20","plan_id":"93B0F9C288","to_date":"2018-07-20"}' -H "Content-Type: application/json" https://api.darkroom.net/v1.3/stores/xihu-store/schedules
{
"response": "ok",
"error_code": 0,
"error_msg": "",
"schedules": {
"2018-08-18": {
"10:00": 0, // 档期已满,无法接受预约
"14:00": 1, // 还可以接受1个预约
"16:00": 3 // 还可以接受3个预约
},
"2018-08-19": {
"10:00": 1, // 还可以接受1个预约
"14:00": 0, // 档期已满,无法接受预约
"16:00": 2 // 还可以接受2个预约
},
"2018-08-20": {} // 如果档期为空,说明是店休日(没有档期),或者日期小于今天
}
}