如果您拥有其它渠道的预约系统(比如有赞商城,或独立网店),但是希望把这些渠道所收到的订单数据汇集到Darkroom「暗房」 进行统一管理,那么这个API接口正是您所需要的。「暗房」的API接口,目前仅限专业版 商家使用。使用API之前,您需要先联系DR客服生成一对API秘钥。对于中小型机构,我们更建议您直接使用「暗房」官方自带的在线预约模块。
获取某一个门店的基本信息、档期设置、以及该门店所含有的全部服务项目。请求路径:
curl -X GET -d '{"api_key":"ABC", "api_ts":1533435628, "api_sig":"...." }' -H "Content-Type: application/json" https://api.darkroom.net/v1.3/stores/xihu-store
{
"response": "ok",
"error_code": 0,
"error_msg": "",
"store": {
"id": "xihu-store", // 该门店的唯一编号
"area": "中国",
"province": "浙江",
"city": "杭州",
"addr": "西湖大道某某大楼123号", // 该门店的地址
"gps_longitude": "87.578587", // 该门店的经度数据
"gps_latitude": "28.672269", // 该门店的纬度数据
"name": "西湖大道店", // 该门店名称
"support_tel": "0571-12345678", // 该门店的客服电话
"support_email": "test_store@example.com", // 该门店的客服Email
"sms_receiver": "13800002222", // 该门店用于接收紧急短信的手机号
// 该门店营业时间的描述:
"open_hours": "上午9点~下午17点",
// 该门店的经营状态(online:正常;offline:停业中):
"status": "online",
// 该门店可接受预约的时间点及最大服务容量:
"max_sessions": {
"10:00": 3,
"14:00": 5,
"16:00": 5
},
"plan_categories": [ // 该门店的服务类型
{
"id": "baby-and-kids", // 服务类型的编号
"name": "儿童摄影类型", // 服务类型的名称
"plans": [ // 服务类型里包含的全部服务项目
{
"id": "newborn", // 服务项目的编号
"name": "新生儿写真", // 服务项目的名称
"deposit": "100.00", // 服务项目的预约订金
"price": "500.00", // 服务项目的官方报价
"status": "online", // 服务项目的状态(online:正常可约;offline:已下架)
"max_sessions": { // 服务项目的可约时间点以及最大服务容量
"10:00": 1,
"14:00": 2
}
},
{
"id": "family",
"name": "亲子写真",
"deposit": "120.00",
"price": "700.00",
"status": "online",
"max_sessions": {
"10:00": 1,
"14:00": 0
}
}
]
},
{
"id": "weddings",
"name": "婚纱摄影类型",
"plans": [
{
"id": "outdoor",
"name": "户外轻写真",
"deposit": "200.00",
"price": "800.00",
"status": "online",
"max_sessions": {
"10:00": 0,
"14:00": 1
}
}
]
}
]
}
}