LOGO

API文档 v1.3

最后更新:2021年8月31日

如果您拥有其它渠道的预约系统(比如有赞商城,或独立网店),但是希望把这些渠道所收到的订单数据汇集到Darkroom「暗房」 进行统一管理,那么这个API接口正是您所需要的。「暗房」的API接口,目前仅限专业版 商家使用。使用API之前,您需要先联系DR客服生成一对API秘钥。对于中小型机构,我们更建议您直接使用「暗房」官方自带的在线预约模块

查询预约档期

查询一段时间内预约某一个服务项目的所有可用档期:

GET    /stores/:store_id/schedules

发送参数列表:

参数名 必须/可选 参数类型 备注/示例
from_date
必须
字符串
查询的开始日期
示例值:"2018-08-18"
to_date
必须
字符串
查询的结束日期
注意:查询的日期跨度不得超过62天
示例值:"2018-08-20"
plan_id
必须
字符串
该门店下的某个服务项目的编号
示例值:"newborn"

通过CURL发送的请求示例:

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": {} // 如果档期为空,说明是店休日(没有档期),或者日期小于今天
   }
}