备注:技师和产品列表变化不大,每天离线定期同步。
备注:接口中所有经纬度,均为火星坐标系(火星坐标与高德、腾讯坐标一致,跟百度之间需要转换)
点评城市ID编码:
点评到家服务项目编码:
如果服务方提供多种类目服务(如美甲,美容),则需要设置serviceId,由点评提供。服务方仅一种类目时,忽略serviceId即可。
点评订单状态码:
返回结果状态码定义:
msg:简单描述
所有接口统一使用HTTPPOST协议,返回结果为JSON。为安全考虑,请求需要做签名,以防止被伪造或串改,双方互相验证对方签名。联调测试阶段可以忽略签名,线上环境需验证。
测试环境AppKey统一为ABCDEFGHIJKLMNOPQRSTUVWXYZ123456
例如,我们请求接口queryAvailableTechnicians(简化版)POST/queryAvailableTechnicians请求参数
服务方验证签名过程示例
接口说明:获取技师列表(服务方所有技师,不区分城市),由点评离线每天调用。如果没有技师概念,需要同点评产品对接人确认后,可不需要提供该接口。
参数说明:
返回结果:
接口说明:获取产品列表,由点评离线每天同步。
字段说明备注:product字段不同频道可能会不同,从packageList以下均为可选字段,可根据频道特定做字段定制
details
展示具体效果见点评app-上海市-到家-宠物-握爪-产品详情页,数据如下(不支持html标签)
成功:{"code":"0","msg":"success","body":{"technicianIds":["10000001","10000002",..]//返回技师列表,默认用第一个}}成功,伪造技师:{"code":"0","msg":"success","body":{"technicianIds":["0"]//伪造技师id,使用0}}
接口说明:用户确认技师后,进入支付页面,点击确认付款,点评调用服务方该接口,创建一个未支付订单。支付必须要10分钟内完成,否则订单过期,库存自动解锁。
参数说明:备注:这些参数是基本信息,不同频道可能有特殊需求,可单独沟通
{"code":"0","msg":"success","body":{"orderId":"12345"//服务方订单id,后续订单操作均以此id为标准}}
接口说明:订单支付后,点评调用服务方该接口,通知订单已付款。
{"code":"0","msg":"success",}幂等性:如果第三方订单处于已支付状态,点评再次调用orderPaied接口,应该返回如下结果(原因:只要保证两边订单状态的最终一致性即可)
{"code":"0","msg":"success",}
接口说明:点评客户端支持用户自己来确认完成订单,用户确认后点评会把该状态同步给第三方(有重试机制)
接口说明:服务方接单后,更新状态进度。服务方更新状态目前只支持13(确认订单)、3(技师出发)、4(服务中)、5(服务已完成)四种状态。
{"code":"0","msg":"success",}测试环境点评接口
接口说明:服务方调用点评,更新订单信息。目前只支持更新服务的指派技师(确认后即可调用),后续视需要可开通更多信息更新。技师id用于做评价及再次预约入口。
接口说明:服务方调用点评,取消订单并退款,不管当前订单状态(如果用户已支付)。目前默认全额退款,后续会支持服务方设置价格。安全考虑,除了签名验证,点评端会做ip白名单。
接口说明:服务方调用点评,查询已同步订单,安全考虑,除了签名验证,点评端会做ip白名单。
{"code":"0","msg":"success","body":{"cityId":1,"productId":1,"serviceTime":"2015-07-0619:30","price":111,"latitude":31.215377,"longitude":121.420333,"serviceAddress":"长宁区安化路492号A6","houseNumber":"长宁区安化路492号A6","cellphone":"13564950570","serviceId":1,"packageId":"1","quantity":1,"status":2}}