LOGO

API文档 v1.3

最后更新:2021年8月31日

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

获取门店列表

获取主账号名下所有门店的列表以及详细信息。请求路径:

GET    /stores

通过CURL发送的请求示例:

curl -X GET -d '{"api_key":"ABC", "api_ts":1533435628, "api_sig":"...." }' -H "Content-Type: application/json" https://api.darkroom.net/v1.3/stores

响应信息示例:


{
   "response": "ok",
   "error_code": 0,
   "error_msg": "",
   "stores": [
      {
         "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
         }
      }
   ]
}