LOGO

API文档 v1.3

最后更新:2021年8月31日

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

获取单个门店信息

获取某一个门店的基本信息、档期设置、以及该门店所含有的全部服务项目。请求路径:

GET    /stores/:store_id

通过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/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
                  }
               }
            ]

         }
      ]
   }
   
}