葡萄生活到家服务订单托管接口文档.doc

葡萄生活到家服务订单托管接口文档 版本 内容 时间 撰写人 备注 V0.9 初稿 2015-07-14 haole V0.95 修改稿 2015-07-15 haole V0.96 修改稿 2015-08-29 fengli V1.2.2 修改稿 2015-09-02 fengli 加入套餐模式，加入定制信息字段 V1.2.3 修改稿 2015-09-07 fengli UpdateOrderInfo接口葡萄和CP方分开； V1.2.4 修改稿 2015-09-08 fengli 加入预约时间说明 V1.2.5 修改稿 2015-09-08 fengli 对请求公共参数区分葡萄API和合作API； V1.2.6 修改稿 2015-09-10 fengli 所有接口改为post请求； 完善交易状态说明； 获取服务时间接口加入注意点，增加时间段格式； V1.2.7 修改稿 2015-09-14 fengli 修改静态服务人员列表查询接口示例错误； V1.2.8 修改稿 2015-09-18 fengli updateOrderInfo状态字段改为string 1整体介绍 3 1.1 定义： 3 1.2 服务对接流程描述 3 1.3 订单托管过程时序图 4 1.3.1 线下支付模式订单托管时序图 4 1.3.2 接口调线上支付模式订单托管时序图 5 1.4 接口调用方式： 7 1.5 接口列表： 7 1.6 接口签名加密 7 1.6.1 公共参数 7 1.6.2 http请求参数排序、签名： 8 1.6.3 参数加密过程： 9 1.6.4 参数解密校验过程： 9 1.7订单状态 9 1.7.1 交易状态（trade_status） 9 1.7.2 业务状态（order_status） 10 1.8接口响应状态 10 2 详细接口描述 11 2.1静态服务人员列表查询接口（queryStaticSource） 11 2.2可预约时间查询接口（queryAvailableTimeslots） 13 2.3可预约服务人员（资源）接口（queryAvailableSource） 15 2.4创建订单接口（createOrder） 17 2.5 订单交易状态通知接口（orderPaied） 错误!未定义书签。 2.6 更新订单业务状态接口（updateOrderInfo） 22 1整体介绍 定义： 该文档用于定义葡萄生活与到家服务提供商之间的订单托管过程，订单托管是指：到家服务提供商将订单的创建，收费等线上过程托管至葡萄生活平台完成，并通过接口进行订单信息的同步，服务提供商根据同步的订单信息为用户提供服务。 服务对接流程描述 服务提供商在葡萄生活开放平台中录入商品信息 葡萄生活为用户提供商品列表以及商品详情展示 用户选择商品创建订单，选择服务时间，服务地点，以及向服务提供商查询服务人员列表进行选择（可选）。 葡萄生活将订单创建信息同步至服务提供商，服务提供商响应订单创建结果以及服务提供商的order_id，后续订单同步接口均以该order_id为索引 订单创建成功后，用户在葡萄生活完成支付，葡萄生活将支付结果同步至服务提供商（供应商接入平台时支付过程可选，若支付方式选择线下方式，则该步骤可省略） 服务提供商根据订单为用户提供服务，并将服务的业务状态同步至葡萄生活以提醒用户。 订单托管过程时序图 线下支付模式订单托管时序图 接口调线上支付模式订单托管时序图  接口调用方式： 本协议描述的所有接口均以http方式提供，请求及响应的编码格式均为utf-8，响应结果均为json结构 接口列表： 功能 接口名 提供方 静态服务人员列表查询 queryStaticSource 服务提供商 可预约时间查询接口 queryAvailableTimeslots 服务提供商 可预约服务人员（资源）查询接口 queryAvailableSource 服务提供商 创建订单 createOrder 服务提供商 订单支付状态通知 orderPaied 服务提供商 更新订单业务状态 updateOrderInfo 葡萄，服务提供商 接口签名加密 1.6.1公共参数 HTTP header公共参数： 参数名 是否必填 类型 说明 Accept-Encoding N String 客户端是否支持压缩：Accept-Encoding: gzip, deflate Accept-Language N String 客户端所使用的语言(默认中文)：Accept-Language: en-US 请求公共参数【葡萄提供API】： 参数名 是否必填 类型 说明 app_key Y string 服务提供商接入