八百方网站商家数据接口规范.v.2.0(1) -13.12.111.doc

八百方网站数据接口规范 密级普通急度普通八百方网站数据接口规范版本：2.0编写时间：2012年03月21日编写：八百方技术部第一章 文档描述1. 文档说明1) 本操作手册用来指导八百方商家实现与八百方商品数据同步。请相关技术人员详细阅读本手册。2) 1、2中 红色标记的文字内容表示需要在以前的基础上补充的功能，“商家商品与八百方商品同步”是需要新加的功能。2. 阅读对象商家开发人员八百方相关技术人员3. 接口联系人职责业务支持姓名徐春映电mailQQ1725857815职责技术支持姓名郭景宇电833EQQ641288940第二章 业务功能描述1. 库存、价格、上下架状态及时查询流程简述1) 八百方系统向商家系统发送对某商品库存、价格、上下架状态查询的请求。2) 商家系统接收请求后将查询到的库存、价格、上下架状态返回给八百方系统。3) 八百方系统接收到返回的库存、价格、上下架状态后对库存进行判断并进行客户是否可以下单的处理。2. 商品价格、库存、上下架状态更新流程简述1) 八百方系统向八百方商家系统发送商品价格、库存、上下架状态更新查询请求。2) 商家系统接收八百方查询请求后将查询到的价格、库存、上下架状态返回给八百方平台。3) 八百方平台接收返回的价格、库存、上下架状态数据并更新商品库。3. 商家商品与八百方商品自动同步流程简述1) 商家系统商品数据发生变更，商家系统向八百方接口地址发送数据同步请求。2) 八百方系统接收数据同步请求进行有效性验证，验证失败则返回错误代码给商家，验证成功则更新八百方系统数据然后返回成功与失败的代码给商家系统。3) 商家系统接受八百方系统返回的代码做相应的处理。4. 接口规范及安全控制1) 所有数据接口均以互联网超文本传送协议（即HTTP协议）为规范标准执行，必须支持GET或POST请求方式。2) 交互的数据同时传递明文字符串及密文字符串，以MD5加密算法标准作为数字签名安全规范，保证交互的数据安全。双方应协商好加密的私钥，以保证数字签名的有效验证。第三章 接口协议1. 库存及时查询接口协议1) 接入urlhttp:/(可访问Stocks网址)?productCode=XXXXX&signtype=md5&sign=XXXXXX2) 接入方式GET/POST方式3) 协议参数变量名含义类型可未空说明productCode商品编码String否商家自身系统的商品编码，此编码需提前提供给八百方匹配好相应商品。signtype加密类型String否目前仅支持MD5加密算法。sign加密字符串String(32)否加密后的密文字符串，加密数据=MD5(商品编码+私钥)。 说明：a) 八百方合作商家返回指定商品的库存、价格、上下架状态数据。b) 内容格式要求：XML格式 Fxxxxxx1234 13.0012.001 注意：当出现查询错误时属性is_fail的值应该为T。2. 商品价格及库存更新1) 接入url http:/(可访问PriceStocks网址)?productCode=xxxx &signtype=md5&sign=XXXXXX2) 接入方式 GET/POST方式3) 协议参数变量名含义类型可未空说明productCode商品编码String否商家自身系统的商品编码，此编码需提前提供给八百方匹配好相应商品。当有多个产品更新时以英文逗号“,”作分割符连接多个商品编码。signtype加密类型String否目前仅支持MD5加密算法。sign加密字符串String(32)否加密后的密文字符串，加密数据=MD5(商品编码+私钥)。 说明：a) 八百方合作商家返回指定商品的库存、价格、上下架状态数据。b) 内容格式要求：XML格式 Fxxxxxxx220135.20135.201注意：当出现查询错误时属性is_fail的值应该为T。3. 商家商品与八百方商品自动同步1) 接入urlhttp:/ /shop/synchronizeProduct?shopcode=xx&productcode=xx&storage=xx&price=xx&marketprice=xx&alive=xx&datetime=xx&sign=xx&returnurl=xx2) 接入方式 GET/POST方式3) 协议参数a) 八百方合作商家构造url参数说明变量名含义类型可为空说明shopcode商家编码String否商家在八百方系统的商家编码productcode商家商品编码String否storage库存int否price商城价double否精确到小数点后两位marketprice市场价double否精确到小数点后两位alive上下架int否上架：1，下架：0datetime当前时间string否yyyyMMdd hh:mm:ss(24小时制)sign加密字符串string(32)否加密后的密文字符串，加密数据=MD5(shopcode=xx&productcode=xx&storage=xx&price=xx&marketprice=xx&alive=xx&datetime=xx&signkey=xx)私钥(signkey)：由八百方提供给商家returnurl商家回调地址否由商家提供b) 八百方返回参数说明变量名含义类型可为空说明shopcode商家编码string否商家在八百方系统的商家编码productcode商家商品编码string否storage库存int否price商城价double否精确到小数点后两位marketprice市场价double否精确到小数点后两位alive上下架int否上架：1，下架：0datetime当前时间string否yyyyMMdd hh:mm:ss(24小时制)sign加密字符串string(32)否加密后的密文字符串，加密数据=MD5( shopcode=xx&productcode=xx&storage=xx&price=xx&marketprice=xx&alive=xx&datetime=xx&signkey=xx)私钥(signkey)：由八百方提供给商家statecode状态编码int否同步失败：0同步成功：1商家编码错误：2商家商品编码错误：3库存格式错误：4商城价格式错误：5市场价格式错误：6上下架格式错误：7验证信息错误：8statede