如果您拥有其它渠道的预约系统（比如有赞商城，或独立网店），但是希望把这些渠道所收到的订单数据汇集到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/orders/123456
{
"response": "ok",
"error_code": 0,
"error_msg": "",
"order": {
"id": "ABC1234", // 订单的唯一编号
"date": "2018-08-05", // 订单的拍摄日期
"hour": "10:30:00", // 订单的拍摄时间场次
"status": "created", // 订单的当前状态（pending：尚未确认预约；created：预约成功/等待拍摄；uploading：原片上传中；choosing：顾客选片中；dispatching：需安排后期修片师；processing：后期修片进行中；downloading：顾客可下载；printing：产品印制中；closed：订单已完成；paused：有问题/暂停中；absent：爽约/未拍摄；canceled：订单已取消）
"store_id": "xihu-store", // 订单所属的门店编号
"created_at": "2018-08-05 16:38:33", // 订单的生成时间
"coupon_code": "XXYYZZ", // 订单的优惠码
"plans": [ // 订单里所包含的全部服务项目
{
"id": "newborn", // 服务项目的编号
"name": "新生儿写真", // 服务项目的名称
"price": "700.00", // 服务项目的实际成交价
"number": 1
},
{
"id": "family",
"name": "亲子写真",
"price": "500.00",
"number": 1
}
],
"total_price": "1200.00", // 订单的总价
"prepay": { // 已支付订金
"amount": "200.00", // 已支付订金的金额
"method": "ali", // 订金的支付方式（alipay：支付宝接口；weixin：微信支付接口；wxmp：微信小程序支付；ali：支付宝(手动)；wx：微信(手动)；pos：POS机刷卡；bank：银行转账；manual：现金；card：会员储值卡；tb：淘宝；dp：大众点评；kbei：口碑网；grp：团购券；cp：优惠券；other：其它）
"remark": "交易号：1234567890" // 订金备注
},
"contact": { // 实际拍摄人
"name": "董小姐",
"gender": "female",
"area_code": "+86",
"mobile": "13011112222",
"email": "test_customer@example.com"
},
"kid": { // 参与拍摄的儿童
"name": "董小弟",
"gender": "boy",
"birthday": "2016-08-02",
"age": "年龄2岁"
},
"customer_remark": "", // 顾客在预约时留下的备注
"team_remark": "", // 工作人员针对该订单的内部备注
"auto_login_url": "https://..." // 给顾客一键登录选片下载的加密链接
},
"customer": { // 订单所属的顾客资料
"id": "3456789", // 顾客的唯一编号
"name": "董小姐", // 顾客的称呼
"store_id": "xihu-store", // 顾客所属的门店编号
"area_code": "+86",
"mobile": "13011112222",
"email": "test_customer@example.com",
"gender": "female",
"order_ids": [ // 顾客已预约过的所有订单编号
"ABC1234",
"XYZ5678",
]
}
}
